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Chapter 1 


Overview 


This reference manual contains the detailed specification of PERSONAL 
PEARL. We have structured this manual to help you find the detailed information 
you need about PERSONAL PEARL. 


Chapter 2 
“~ 

Chapter 3 

Chapter 4 

Chapter 5 


Contains detailed reference material that you need to know as 
you become more familiar with PERSONAL PEARL. Rely on tt 
when you need detailed specification on the functions of 
PERSONAL PEARL. 


Provides a detailed look at some of the more powerful 
features of PERSONAL PEARL. The first feature is multiple file 
processing through which you may reference information that 
has been stored on other forms. The second feature covers 
information on computations. Computations can be entered 
into forms and reports and can make direct use of information 
stored on other forms. The third feature covers multiple record 
types and control information wherein information in several 
formats reside in the same file. The fourth feature discussed is 
directory maintenance. Finally cursor positioning is covered 
along with some special command functions that can be used 
in respect to the cursor. 


Explains design aids to be used when laying out reports or 
forms. These aids are obtained using the CP/M ctrl/P 
command during the design process. The different form or 
report design steps you used and your design specifications 
are shown in the layout reports. 


Deals with the file maintenance facilities of PERSONAL 
PEARL, i.e., PEARLFM. This set of utilities is no less important 
than the others, but is not needed until you have something to 
maintain. The reason you need these advanced facilities will 


ot 
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become apparent once you have understood and gained 
more knowledge of PERSONAL PEARL. This chapter pro- 
vides instructions about file maintenance. 


Chapter 6 Provides a summary review of some of the CP/M file 
maintenance utilities you are most likely to use for any 
software package using CP/M. The CP/M file maintenance 
commands are not covered in detail. We feel that in-depth 
understanding of CP/M is most appropriately covered in your 
CP/M user’s manual and those manuals which come with 
your computer. 


Chapter 7 This chapter is for programmers and contains a discussion 
and an example of how data from PERSONAL PEARL data 
files may be processed by programs written in BASIC. 


Chapter 8 Contains a discussion of the security and privacy features of 
PERSONAL PEARL. 


Briefly, the appendices contain those special items of information that may be 
used most frequently, and where ease of access is important. 


Appendix A,B Contain information about special messages you may receive 
from PERSONAL PEARL. An explanation of what happened, 
the reasons and the actions you may need to take are 
included. 


Appendix C Covers the details concerning the installation codes in 
INSTALL.DAT. 


Appendix D Covers the different ways that your PERSONAL PEARL disks 
can be set up (what files on what disks) for your final daily 
production use. Useful combinations of files are suggested. 


Appendix E Contains a full and general explanation of file maintenance 
using PEARLFM. Although it is not more detailed than Chapter 
5, it does explain what happens during file maintenance in a 
different manner. 


Appendix F Gives a detailed account of the control key commands from 
the various CONTROL KEY COMMAND lists. It is a back-up 
for and documentation of the display screens and HELP texts. 


Appendix G 


Appendix H 


Overview 3 


Contains a file of the HELP text that is provided with 
PERSONAL PEARL “on-line”. It is provided for those users 
who do not wish to maintain the help text on disk because of 
space requirements. 


Gives a detailed look at interfacing SuperCalc with 
PERSONAL PEARL. 


Chapter 2 
General Reference 


INTRODUCTION 


The information contained in the general reference sections of this manual is 
intended to clarify some points already addressed in the User's Guides, and to 
provide additional explanations for the specific functional areas of PERSONAL 
PEARL. 


Just as the tutorials took you through step-by-step, first laying out the form, then 
the report, then entering data, and finally, producing reports, this general 
reference section takes you through additional detail you may need in order to 
accomplish specific types of processing. Each section provides a brief 
summary of specific actions involved, plus any additional specific steps which 
may be optional. 


This manual was written to expand the knowledge you gained from the User's 
Guides as well as to be used as a reference manual during creation of your own 
personal information systems. 


DESIGN FORMS 


FORM DIRECTORY 


Before designing a form, it must present on the PERSONAL PEARL Form 
Directory. You may enter the name of a predefined FORM (which appears in the 
Form Directory), or you may create anew NAME using up to seven characters 
and giving the form a DESCRIPTION. 


You will be prompted to enter: 


NAME The form name may be from one to seven characters 
long. This is the name of your form. This name will 
also be the name of a family of disk files with different 
file types associated with the form. 


Example: ADDRESS 
~5 
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DESCRIPTION 


MESSAGES 
ADDED 


OK TO DELETE 
(Y/N) 


NAME NOT 
LOCATED 


The FORM DESCRIPTION is provided as an aid to 
you later on when you select a FORM from the Form 
Directory. You provide the DESCRIPTION when you 
add a new FORM. The description may fill up the line 
provided on the screen when the prompt is displayed. 


Example: MY ADDRESS BOOK 


This message tells you that the name you have 
entered has been added to the Form Directory. Press 
RETURN to continue with the FORM you have added 
(wherein the message changes to SELECTED), or 
enter a different name. 


You may delete a form name by entering the name 
and then pressing ctrl/O. 


If you wish to continue the delete, you enter a “Y”. If 
you decide you do not wish to delete the form name, 
you press “N”. 


NOTE 


Deleting a name from the Form Directory does not delete 
any files on disk that may be associated with that name. In 
other words, if you have designed a form (such as 
ADDRESS) and you delete the name ADDRESS from the 
Form Directory, your address files will still be on disk. (See 
Appendix D for a description of program files.) You must 
“ERAse” them from disk using your CP/M erase command if 
you no longer need them. 


ERA B:ADDRESS.* 


The above action would erase all the files created by the 
previous tutorial on ADDRESS. If you have not erased your 
files from disk, but you have deleted the name from the 
directory, you cannot access the form files again unless you 
put the name back in the Form Directory. For more on 
PERSONAL PEARL directories see the section on directory 
maintenence. 


This message tells you that the FORM name you have 
entered is not in your Form Directory. You must either 
enter a name already in the Form Directory, enter a 
new name to ADD, or press ESCAPE to end pro- 
Cessing. 


General Reference Fg 


STEPS FOR FORM CREATION 


| Five steps are involved in designing a new form. If you are designing a new 
form, select step 1 and then select each of the subsequent steps until the form 
is installed (steps 3 and 4 are optional). You may return to any step to make 


additional changes. A data area must appear in the layout before it may be 
defined in step 2. Likewise a data area must be defined in step 2 before it may 
be referred to in steps 3 and 4. 


Step 1: FORM LAYOUT 


To LAY OUT a FORM, enter the form layout similar to the way you would lay out 
a FORM on a piece of paper in a typewriter. The areas into which data will be 
entered can be specified by using underscores (‘~" character). For numeric 
data, you may use underscores for integers without punctuation, or you may 
fully format numeric areas using 9’s for digit locations and the dollar, comma, 
period and minus signs for punctuation. 


For example: 
NAME: —_____ AGE: 99 SALARY: $999,999.99 
BIRTHDATE: mm/dd/yy 


SYMBOLS USED FOR FORMATTING NUMERIC AREAS 
Symbol Description 

9 for a digit position. 

$ in the first position will set a fixed dollar sign. 

$$ — in the first two positions will set a floating dollar sign. 


- in the last position sets a trailing minus sign. The default is a leading 
minus sign. 


a single period sets the decimal place. 
; commas may be used to group digits in the usual way. 


PERSONAL PEARL treats all numeric data areas with sixteen digits of precision. 
-™ You may have sixteen digits of precision to the right or left of the decimal point, 
or somewhere in between. 
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FORMATTING DATE AREAS 


It is good practice to format date areas as shown in the BIRTHDATE example 
above. However, any eight character string may be used, for example, eight 
underscores. 


PRINTING FORM/REPORT LAYOUTS 


You can also produce a printed report of all the definitions you have made by 
entering a ctrl/P (see Chapter 4). The report is produced on your printer and 
includes the definitions made in this step and the three steps following (i.e., data 
input areas, index for finding records and data from other forms). 


Step 2: DATA INPUT AREAS 


Your next step is to distinguish more clearly areas into which information will be 
input from areas which are background text on the screen. This is done by 
giving each data input area a name, a type and specifying whether the input of 
data is mandatory or not. 


You do this by simply moving the cursor to the first character of the data input 
area and pressing the ctrl/B combination. The data input area will then be 
highlighted, and you will be prompted to answer the following questions: 


NAME THE Enter a one to seven character name that can be 
DATA INPUT referenced later on when you design reports and 
AREA HERE other forms. For example: “NAME”, “ADDRESS”, 
“PHONE”, “AMOUNT”, “TOTAL”, “CUST”, “CUST2”, 
and so on. 
NOTE 


If you intend to use this input area name in a computation, 
then it must start with a non-numeric character (see also 
Chapter 3 and Appendix A). 


IS INPUT Decide whether the data in this area is always 
REQUIRED? required and therefore must be entered in order to 
complete information on the form: 


Enter “Y” to prevent entry operator from leaving this 
area blank. 


Enter “N” if data entry is not always required. 


TYPE OF INPUT 


FORMULA FOR 
COMPUTATIONS OF 
INPUT (OPTIONAL) 


General Reference fe) 


Choose whether the data area will be characters 
(may be textual or numeric), numbers (for Compu- 
tations or numbers that you want aligned to the right of 
the column, or date for dates: 


The “C” option allows either characters or numbers to 
be entered. 


The “N” option says that the data input area is 
numeric and so may be used in calculations. 


The “D” option says the data input must be a date. 


NOTE 


You cannot change a data input area TYPE once you have 
defined an input area as either “C’, “N”, or “D”, and have 
then installed the form and finally, entered data into the form. 


If you need to change a previously defined data input area 
TYPE, you will need to rename the input area and to re-enter 
any data that you had stored in the form before the change 
occurred (See Appendix A.) 


lf the data area is to a computer numeric area, then 
enter a formula for a computation: 


A FORMULA may be entered to compute a numeric 
data input area based on other areas in your form. 
You may use “+” to add values; “=” to subtract 
values: ‘“*” to multiply two values together; and “/” to 
divide one value into another. 


You may also use parentheses to show the order in 
which a computation is to occur. For example: 


(A+B) *C means to add A and B, then multiply 
the total times C. 


If no parentheses are used, multiplications and divi- 
sions will occur before additions and subtractions. 
(See Appendix A and Chapter 3.) 
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Optional Step 3: INDEX FOR FINDING RECORDS 


Index areas are used to select data forms (or records) that have been added to 
the program data file. In this way, you can find and identify individual records. 
Index areas are also used to create a “path” index for access from other forms. 
Any data area may be used as an index, and several indexes may be defined. 
To define an index area, position the cursor to the beginning of the data input 
area containing data you want to use as an index. Then press the ctrl/B 
combination. Once you have done this, you will be prompted to enter the 
options associated with an indexed area. Examples of commonly selected 
indexed categories are names and |.D. numbers. 


This step is optional. You do not have to make any area an indexed area. It is 
recommended that at least one data input area be selected as an indexed area. 
If no indexed areas are specified during the design of a form, the first data input 
area on the screen will automatically be assigned as an indexed area. 


Designating an input area as indexed allows the input area to be used as a path 
or link to the form when accessing it from other form. (see discussion on DATA 
FROM OTHER FORMS in this section). 


If you do not remember which data input areas are “indexed” areas, you may 
enter a ctrl/P to highlight those input areas on your form which have already 
been specified as indexed areas. 


The following prompts are displayed when Step 3 is selected: 


WILL YOU USE Enter “Y” to designate that the input area is to be an 
THIS AREA TO indexed area, or “N” to designate the area as not 
IDENTIFY AND indexed. 


FIND INDIVIDUAL 
RECORDS? (Y/N) 


lf you answer Y to the above question, then answer 
the next question, otherwise you may ESCAPE or 
RETURN. 


WILL DATA IN Enter “Y" to show that there is one and only one 
THIS AREA corresponding record for each data entry placed in 
UNIQUELY this indexed data input area. 

IDENTIFY ONE 

RECORD IN THIS Enter “N” to show there may be duplicate names or 
FILE? (Y/N) numbers entered in this indexed data input area. 


For example: 


On a customer master file, you would probably never 
use the same customer id number for two different 
customers (enter Y). On the other hand, you may find 
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that two of your customers happen to have the same 
name (enter N). 


NOTE 


Once a form has been installed and data records have been 
entered into the form, changes to indexed data areas will 
require that you rebuild the index. You can change an 
indexed input area to nonindexed or a nonindexed area to 
indexed, provided that you reinstall your form and then 
rebuild the index using Service 2 of the File Maintenance 
facilities. If you have set up separate production disks, then 
you should make sure that you have transferred the FORM 
changes using Service 4 of the File Maintenance facilities. 


Optional Step 4: DATA FROM OTHER FORMS 
This step is used only when data from another form is to be accessed. 


PERSONAL PEARL allows you to get information from other forms when you 
are entering data, or producing reports. To access data from another form, one 
data area is designated as the path, or access key to the other form. Other data 
areas may then be defined as being brought over from the-other form. The data 
which is brought over from the other form may be kept on the file or may be 
displayed but not kept on the file. (See Chapter 3 for more details.) 


The data areas involved in sharing information between two forms must have 
the same name and type. It is not necessary for the areas to have the same 
length, but it is good practice for the path area to be the same length. The area 
designated as the path to the other form must have been defined as an index on 
the other form (it need not be an index on the current form). 


In order to designate a data input area as coming from another form, place the 
Cursor on the first character of the data area, press ctrl/B and answer the 
questions that follow. 


WHAT IS THE Enter the name of the FORM containing the data input 
OTHER FORM area you wish to receive. 

NAME ? 

WILL DATA IN Enter a “Y” if this input area is to be used as a path to 
AREA IDENTIFY identify a particular record in the other form. A “Y" 
AND LINK here provides PERSONAL PEARL with the “path link” 
ANOTHER which creates the “access key’. Only one area may 
FORM? (Y/N) be set as the link to a particular other form. If two other 


forms are to be accessed, then two areas will be 
designated as paths, one for each other form. 
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Enter an “N” if this input area is to be obtained from 
another form but does not specifically identify the 
other form. 


If you respond with an “N” to this prompt, you will be 
further prompted as follows: 


IS DATA FROM Enter a “Y” if the data obtain from the other form is to 
THE OTHER FORM be displayed, but is not saved on the current form. 


BR FT IN . 
Sear ia Enter an ‘‘N” if the data is to be DISPLAYED and then 


SAVED on the current form..In this case, you have the 
ISP ? 
ae oe option to change the data after it has been obtained 
from the other form. 


If you do not remember which areas have been 
defined as input from another form, you may press 
ctrl/P to highlight those input areas on your current 
form. s 


Step 5: FORM INSTALLATION 


Once you have completed definition of your data entry form, you need to 
INSTALL it so that you may enter data into it. 


You may change the layout of any of your forms after an installation. However, 
these changes will not take effect until you reinstall the form. Forgetting to 
reinstall the form will result in no changes in the entry of data. 


If the form you are installing gets information from another form, then the 
second form must be installed first. In practice, this means that when you are 
defining the path between the two forms, you will need to install the form which 
information is coming from prior to installing the form the information is going to. 


Also, you cannot install a form unless at least ONE data input area has been 
defined. If you try, the following message will appear: 


ATTEMPT TO Your form cannot be installed until at least one data 
INSTALL WHEN NO input area has been defined using option 2 of the 
DATA INPUT AREA selection menu. 

SPECIFIED 
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ENTER DATA - Adding, Editing and Deleting 


Use Service 1, ENTER DATA (PEARLED) to enter, edit and/or delete data from 
the forms you create. Once you select the program you wish to work with from 
your FORM DIRECTORY, the form will be displayed on the video screen, and 
you will automatically be in ADD mode. If you have already entered data into the 
form you have selected, you may wish to EDIT the data by switching to EDIT 


mode (ctrl/B). 


The following control keys are displayed at the bottom of the screen when 
ADDing or EDITing data into your forms using PERSONAL PEARL: 


U - Save/Replace record B —- Switch ADD/EDIT Z - Get next record 
N - Duplicate last item E - Move cursor up W - Get previous record 
P = Print current record X — Move cursor down 0 - Delete current record 
Q - HELP I - Tab forward ESC - EXIT 
ADD mode While you are in ADD mode, enter data into the data input areas 


on your input form. Then press the ctrl/U key to add the record 
to the file. When the form does not end with a computed 
numeric data area, you may also add the record to the file by 
pressing RETURN a second time while the cursor is in the last 
data input area on the form. The data input areas will then be 
cleared so you may begin entering data for the next record. 


When PERSONAL PEARL is ready for you to enter data, you 
may use the RETURN or TAB key to move from area to area 
during data entry. Again, depression of the ctrl/U (or pressing 
RETURN twice) on the last data input area ADDs the record. 


When entering data into a data area which is a path to another 
form, PERSONAL PEARL will attempt to access the record 
which the data you have entered identifies. If a record is on file 
in the other form with the same key, then the input will be 
accepted. If the record is not found in the other file, the _ bell will 
sound and data areas which were to be brought from the other 
form will be displayed as asterisks. In practice, you will not enter 
the key exactly as it appears in the other form. You will, 
however, have positioned the index “close” to the desired key. 
The next step is to scan the other form using the ctrl/Z and 
ctrl/W commands to find the correct record. 
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EDIT mode 


DELETEing 
records 


EX 


MESSAGES 


You may switch to EDIT mode by pressing the ctri/B key 
combination. The ctri/B command switches back and forth 
from ADD to EDIT mode. 


After you press ctrl/B to enter the EDIT mode, you will be asked 
to ENTER KEY. This means that PERSONAL PEARL is waiting 
for you to enter a key character, word or number into an 
indexed data input area so it can identify the record you want to 
display, edit or delete. Alternatively, you may use ctrl/Z to get 
the next record in the index. Initially you are positioned to the 
first record in the first indexed area. 


If you are in EDIT mode, you must first get a record from the 
data file in order to change or DELETE it. This can be done by 
entering data in any indexed area, or by pressing the ctrl/Z (get 
next record) or ctri/W (get previous record). You may then 
DELETE the record from the file (ctri/O), or EDIT the record and 
then replace it on the data file (ctrl/U). 


If you need to abandon your edits, enter an ESCAPE. You will 
then be asked if you want to EXIT. 


In order to delete a record, you must be in EDIT mode and the 
record to DELETE must be on the screen. A delete request 
Cannot be made if no record has been obtained for deletion. 


To delete a record, enter a ctri/O. You will then be asked 
DELETE (Y/N). Enter a “Y” if you wish to delete the current 
record on the screen. Otherwise, entry of an “N” will continue 
processing and not delete the record. 


You may exit from ADD/EDIT processing. When you depress 
ESCAPE, PERSONAL PEARL will respond EXIT? Reply with a 
“Y” if you wish to leave entry/editing. 


You will enter “N” if you wish to continue entering data into your 
data file. If you wish to continue, PEARL will respond with 
CONTINUE EDITING. 


These messages are designed to validate input requests and processes. They 
will appear at the bottom of your video display screen. 


EDIT OPTION You have tried to use an EDIT function in ADD mode. 
Press ctrl/B a second time to switch to EDIT mode. 
DATA REQUIRED This data area is required. You must enter data into 


this area before the record can be added. 


ADDED 


RECORD DELETED 


RECORD REPLACED 


DUPLICATE KEY 


NUMBER TOO 
LARGE 


INVALID DATE 


RECORD NOT 
FOUND 


END OF FILE 


SPECIAL MESSAGES 
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The data you have entered has been added to your 
data file. You may now enter data for another record, 
or press the ctri/B key a second time to switch to 
EDIT mode. 


The data record has been deleted. Enter ctrl/B to 
return to ADD mode, ctrl/Z to get next record, ctrl/W 
to get previous record, or enter data into an indexed 
data input area to identify another record to edit. 


The data record has been replaced. Enter ctrl/B to 
return to ADD mode, ctrl/Z to get next record, ctrl/W 
to get previous record, or enter an indexed data input 
area to get another record to EDIT. 


The record cannot be added because the area 
specified is UNIQUE to another record already in your 
file. 


Not enough digits in the field to fit the numeric value 
entered. Enter a smaller number. 


Enter date in format mmddyy or mm/dd/yy. Examples 
of correct date entry formats: 12/31/81, 12 31 81, 
123181, 12-31-81, etc. 


Dates which do not exist, like 12/34/82 are also 
rejected as invalid. 


A record on another file cannot be located based on 
the indexed input area you have chosen. Enter a valid 
indexed value, or ctrl/Z or ctri/W to get next or 
previous record. 


You have come to the end of or the beginning of the 
file. 


Special messages cover specific conditions which may need attention in order 
for processing to be continued. Special messages provide solutions to these 
conditions. See Appendix A should one of these messages appear. 


EDITING AN EXISTING DATA FILE AFTER FORM CHANGES 


In some instances, you will want to change your forms in some way after you've 
entered information and created a data base. PERSONAL PEARL lets you 
change the forms without disturbing your existing data base. You'll be able to 
use your edited form to add more data, or to print reports. Re-entering 
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information will not be necessary in most cases, but you will need to use the 
transfer options in the PERSONAL PEARL File Maintenance function 
(PEARLFM) to transfer form changes to production program files. See Chapter 
5 and Appendix E. File maintenence is occasionally required after form 
changes; when this is the case a message will be displayed upon entry to the 
ENTER DATA program. 


DESIGN REPORTS 


DISCUSSION 


This section covers PERSONAL PEARL report features. It is intended to tie 
together all the options associated with defining and producing reports. 


A report is a part of a program unit. It is necessary for the form to be defined first 
before a report can be created. Once the designed form has been installed, you 
may then proceed to define and create reports for the form. You may make 
changes to the report layouts, contents or controls at any time. This is done by 
making the changes desired and reinstalling the report. If you make changes to 
the form, then you should reinstall all reports for the same form. 


DESIGN REPORTS - FEATURES 
@ There are three report types: fixed, list, and SuperCalc. 


@e You may design reports from scratch, from an input form or from a 
previously designed report. 


@ Allows for on-screen report formatting. 

@ You may create printed reports that are wider than your video screen. 

@ You may sort on up to five data areas, in ascending or descending order. 
@ You may use data form other forms. 

@ Youcan redesign your reports as often as desired. 

DESIGN REPORT PROCEDURES 


In this section, we will first detail adding a new report to the report directory, then 
go on to detail the design process. Selection of the report type is part of adding a 
report to the directory, so the report directory section will include a discussion of 
the three report types available. 
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REPORT DIRECTORY 


The report directory is similar in function and operation to the form directory. 
The main difference is the new report options displayed when a report is added 
to the directory. 


Report names are up to seven characters in length, starting with a letter, not a 
digit. 


MESSAGES 


DUPLICATE NAME This message is displayed if the name of the report 
you have entered has already been used as a report 
name by another program or program unit. PEARL 
does not allow the same report name to be used by 
two different programs or program units. 


TO OELETEA You may delete a report from the Report Directory by 

REPORT entering the name of the report and then pressing 
ctrl/O. 

OK. TO: DELETE? You will be asked to enter “Y” to continue deletion of 


the report from your Report Directory, or enter an “N” 
to cease deletion of a report. 
NEW REPORT OPTIONS MENU 


If you are creating a new report, you will have three options, prompted as 
follows: 


Option 1 To create a report that uses the same layout as your input form. 
This will create a fixed-type report. 


Option2 To copy an existing-report. Once you have made a copy of the 
report, you may change the layout of the report. 


Option3 Tocreate a new report on a blank screen. 


MESSAGES 
INPUT FORM This message is displayed if you tried to create a 
NOT LOCATED report using an input FORM before the FORM was 


created. You must create the input FORM first. 


a 
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GIVE PEARL THE 
NAME OF THE 
REPORT TO 
COPY: 


REPORT NOT 
LOCATED 


REPORT LOCATED 


DESCRIBE: 
(name of 
report) 


If you wish to make a copy of an already existing 
report, you will be prompted to enter the name of a 
report you have previously defined. If you do not 
remember the names of your reports, you may press 
ESCAPE to return to the report directory to view the 
report names. 


lf you have selected to copy an existing report and it 
cannot be found, the above message is displayed. 
You will need to either enter a different report name, or 
press ESCAPE to return to the report directory. 


The above message is displayed if the report layout 
was already on a disk file even though the name of the 
file was not in the report directory. You may wish to 
change or continue with the same name. 


Once you have given your report a name and decided 
on one of the three available options, you will be 
prompted to enter a description of the report. This 
description will be included in the Report Directory. 


CREATING A REPORT FROM SCRATCH 


lf you choose to create a new report from scratch, you will be asked for the 


report type as follows: 


WHAT KIND OF 
REPORT ARE 
YOU DEFINING? 


LIST 


There are three different types of reports available: 
FIXED, LIST and SuperCalc spreadsheet. 


A thorough discussion of each is included on the 
following pages. The report type is an important 
consideration when designing the report format, espe- 
cially Step 1 of the report design menu. 


Use a LIST-type report when you wish to summarize the data from the input 
forms, placing as many lines as possible on each page. 


When you create a LIST-type report, you may specify page headings, summary 
subtotals, and grand totals and footings. 


List-type reports are used for reporting information which summarizes records 
with subtotals and totals, or which print several records on a page. 


Lines on a list-type report are divided into five groups or categories. These are: 
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HEADING A place to put the report title, page number, and any 
other information helpful in identifying the report. The 
HEADING will be repeated at the top of every report 


page. 


DETAIL A place where one or more lines on the report may be 
designated for the output of data from a single record 
on the program data files. Detail lines will be repeated 
for each record read from the data file on the report 
page until the end of page is encountered. DETAIL 
lines will start with the first record on the program data 
file or the first record specified on the report subrange 
(LOW range). Information in the DETAIL will appear in 
the report for each record selected. 


SUBTOTAL A place where a subtotal line or lines will be printed. A 
subtotal is printed when a change occurs in the data 
in the first SORT category is detected when reading 
records from the program data file. 


TOTAL A place where totals for the report will be printed. This 
may be one or more lines. It will be printed when the 
report has reached the end of all data in the program 
data file or the end of the report subrange (HIGH 
range). 


FOOTING A place where a page number or other report identifi- 
cation information may be printed. The footing will 
appear at the bottom of every report page. It may be 
one or more lines. 


To change the report group for designing a line of the report, use the ctrl/C and 
ctrl/R commands to cycle through the groups. To change the group to which a 
report line has already been assigned, delete the line and change groups, then 
reenter the line. 


NOTE 


Be sure to define some detail or subtotal or total lines in a list report. A list report whose 
lines are all part of the heading will not have any output, since no heading is printed until a 
detail, subtotal or total line is output. 


List-type reports also provide some special symbols which will cause page 
breaks or blank lines and automatic page numbering the report. 


<BLANK> A special symbol which will cause a blank line on the 
report. Useful for double spacing lists. 
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<PAGE> A special symbol which will cause a page break when 
encountered. For example, this symbol may be used 
to start a new page after a subtotal. When a new page 
is started, the footing for the previous page is printed, if 
one is defined. The heading, if one is defined, will then 
be printed on the next page. 


SHER Four pound signs is a symbol which will cause the 
current page number to be printed in that location. 
This symbol is usually used in a heading or footing 
line. 


FIXED 


Use a FIXED-type report if you want each record to appear on a separate page. 
You also use. this report type for multi-up reports or labels. 


A fixed-type report allows you to define a report in the same way that you design 
a FORM. This “report form” will be repeated on the report page every time a 
record is read from the program data file. 


Fixed-type reports are useful for generating form letters, mailing labels, and 
other documents which do not require subtotaling and totaling. This type of 
report may be printed multi-up, that is several forms across one page. 


A fixed-type report is used for (but is not limited to) the printing of labels. The 
principle is that you design the layout and content of the label that will be 
repeated for every record read from the form data file. When you get ready to 
produce the report, you may specify the number of labels that are to be printed 
from left to right on the report page. 


You can create a fixed-type report in three ways. 
@ One way is to specify that the report is a copy of the program FORM. 


e Another way is to design the report from scratch and then specify it as 
FIXED when you first define it. 


e The third way is to use are fixed-type report as the starting point. 
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SUPERCALC (Version 1.07 compatible) 


Use the SuperCalc spreadsheet option when you wish to create a SuperCalc 
spreadsheet input file from your Program Data File. 


When you use this option, the data output areas in the report will become “cells” 
in the spreadsheet. Thus, this type of report will create a file which may then be 
used as the input to SuperCalc. 


A SuperCalc report is not produced on paper or on the terminal screen. Instead, 
it is produced as a file on a disk because it is created as a “spreadsheet” for 
integration with the SuperCalc software package. 


To produce a SuperCalc spreadsheet, you simply design a report in the same 
way you design a list-type report. The same categories apply to the SuperCalc- 
type report (i.e., HEADING, DETAIL, SUBTOTALS, TOTALS and FOOTINGS). 


Only data areas containing NUMERIC data will be included in the spreadsheet. 
Each numeric data area will be represented as a spreadsheet “CELL”. All data 
areas with non-numeric data and report “background” will be ignored. 


The data areas in each of the DETAIL, SUBTOTAL, and TOTAL categories will 
each be output on a single line on the spread-sheet. All numeric data areas on a 
line will be output’ onto the spreadsheet as contiguous CELLS (i.e. no empty 
cells will exist between two CELLS with data.) The first column of the 
spreadsheet will be left blank. 


The spreadsheet file to be produced will automatically be given the disk file 
name of “TEMP.CAL” by PERSONAL PEARL. It will be output or written to the 
diskette on the PERSONAL PEARL disk drive (A:). You may change the name of 
the spreadsheet file and the disk drive to which it is to be written selecting 
Service 2 (Print Out Details) of the PERSONAL PEARL Produce Reports menu. 
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The following is a sample PERSONAL PEARL report layout. 


HOWARD COOPER 
2586 LANCASTER BLV. SE 
COMPUTERVILL, WA. 


CURRENT CHARGE PAYMENT BALANCE 
200.00 100.00 100.99 
34.00 00.00 34.00 
50.00 00.00 50.00 
SUBTOTAL 284 .00 100.00 184.00 
JOAN LOLAN 
RT. BOX 67 
HILLVALLY, AL 
CURRENT CHARGE PAYMENT BALANCE 
10.00 0.00 10.00 
0.00 10.00 -10.00 
SBTOTAL 10.00 10.00 0.00 
GRAND TOTAL 294.00 110.00 184.00 


The SuperCalc spreadsheet produced from the above report layout will have 
the following format: 


10.00 0.00 10.00 
0.00 10.00 -10.00 
10.00 10.00 0.00 


SOON OU FWD 
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DESIGN REPORT STEPS 


The design reports steps are in the logical sequence in which they are 
performed in order to create a report. The steps may be repeated, but some 
steps must be performed before others, as follows: 


e Adata area ona report must be laid out in step 1 before it may be defined 
in step 2. 


e An __ area must be defined in step 2 before it may be specified as being 
brought in from another form in step 4. 


@ Step 3 may be performed at any time. Within the above constraints, the 
steps may be repeated any number of times in any order. 


Step 1: REPORT LAYOUT 


In this step, the report format is typed onto the screen in a manner similar to that 
of designing a form. In list-type reports a number of special symbols may be 
used to control page numbering and spacing. In both list and SuperCalc reports, 
lines are identified by group; heading, detail, subtotal, total and footing. 


Report layout is slightly different for each of the report types. More information 
about specific report types was presented the previous section on the report 
directory. 


To layout the report, or to change the layout of an existing report use the control 
keys to edit the report format. Use underscores and numeric formatting 
characters in the same manner as that used to layout a form. 


FIXED In order to lay out a FIXED-type report, continue in the 
same manner you would to lay out a FORM. 


LIST A LIST-type report is used if you want to list summary 
information, and to compute totals or subtotals from 
the information entered into your entry form. You may 
also specify headings and footings for each page of 
the report. 


As you lay out a LIST-type report, you must specify 
the type of category you are entering. The categories 
are: HEADING, DETAIL, SUBTOTAL, TOTAL and 
FOOTING. 


In order to change the report category, press the 
ctri/C combination. The category being used will 
appear in the bottom left-hand corner of the REPORT 
LAYOUT -- CONTROL KEY screen. 
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SUPERCALC 


WIDE REPORTS 


You may add lines to reports at any time. To do so, 
simply position the cursor to the area into which you 
want to insert a new line and select the appropriate 
report category. You may also delete any line from the 
report. You cannot change a report line category 
directly. To do so, you must delete the line, and then 
reenter it into the new report category. 


The SuperCalc report is similar in format to the LIST- 
type report. Each set of detail, subtotal, or grand total 
information may be placed as a row of data in the 
SuperCalc spreadsheet. Within these three groups, 
each output area you specify will be placed as a cell 
in the spreadsheet beginning with the second cell in 
each row. (Refer to your SuperCalc manual for more 
details.) 


When you produce the SuperCalc report, it can be 
output to a disk file for SuperCalc to use. 


You may design reports that are wider than your video 
screen. If your video screen can scroll horizontally 
(your screen can move from left to right and back), 
then you simply move your screen sideways to con- 
tinue the layout of each report line. If your video 
screen cannot scroll horizontally, then you may 
extend each line layout by ending it with a blank 
space followed by a dash “-” and continuing the same 
report line on the next line of your screen. You may 
not place the continuation character in the middle of 
an output area. 


For example: 

If your video screen supports 40 characters per line 
(40 columns), and you wish to create a report that is 
70 columns wide, then you simple layout each report 
line using two video screen lines as follows: 


40-column video screen layout of 70 column report: 


Name : Address: - 


The report will print as follows: 


Address: 
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Step 2: DATA OUTPUT AREAS 


Once you have finished the layout for the report, the next step is to identify the 
areas on the report where information from your data file will be placed during 
printing. These output areas are defined in essentially the same manner as data 
input areas on the input form. 


All of the areas which have been specified for output are highlighted on your 
screen. In order to specify a new data output area in a report, place the cursor 
on the first character in the output area, and then press ctrl/B. At this time, the 
data output area will be highlighted, and you will be asked to give it a name. 


The following prompts are displayed: 


NAME THE DATA 
OUTPUT AREA 
HERE: 


FORMULA FOR 
COMPUTATION OF 
OUTPUT 
(OPTIONAL): 


Specify the name of a data input area in your input 
form in order to print information from your data file. 


If the output area is to contain data in an entry form, 
use the same name you used to name the data input 
area. If the new area is to be computed, or if the area 
is a computed value, then you should assign a new 
name. 


If an output area is to be computed during creation of 
the report, give ita new name,then specify the formula 
to be used to compute the area based on other data 
areas in the input form. 


A FORMULA may be entered to compute a data 
output area based on other areas in your form. Those 
other areas need not be present on the report form as 
long as they have been defined on the entry form. 


For example: 


lf two areas on your input form are named HOURS 
and RATE, you could compute the product of these 
two values and place it in your report under the new 
name of GROSS by entering GROSS as the output 
area name, and using HOURS * RATE as the 
FORMULA to compute GROSS. 


In your FORMULA, you may use “+” to add values; 
“=” to subtract one value from another; “*” to multiply 
two values together; and “/” to divide one value into 
another. You may also use “(” and “)” to indicate the 
order in which the computation should occur. 
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For example: 


(A + B) * C causes area A and B to be added and 
then the total to be multiplied times area C. If no 
parentheses are used, multiplications and divisions 
will occur before additions and subtractions. 


The following messages may appear in regard to computation of formulas: 


EXTERNAL FILE You may not compute a value also specified as being 
CONFLICT a data input area from another form. 
SYNTAX ERROR There is a syntax error in your formula. The type of the 


error may be as follows: 
& Unbalanced parenthesis. 
& An input area name Is too long. 


8 Order of input area names and arithmetic opera- 
ators (i.e., +, ~, /, *) is invalid, OR 


& The first character of an input area may not 
start with a number. 


The Advanced Tutorial Guide and Chapter 3 of this 
manual cover specific examples of computations. 


Step 3: SORT PRIORITY 


Use this option to specify the order in which the records on the input file will be 
placed on your report. If no sort priority is specified, then the records on the 
report will appear in the order in which they physically appear on the data file. 
This order is unpredictable. If only one sort order is specified, and the data area 
has been defined as an index, then the index will be used to sequence the 
records on the report, and no sorting will be done. 


You may also specify the order in which the report will be printed based on any 
of the information present in the program form, regardless of whether or not the 
data area appears on the report. Computed areas may not be used to sort the 
file. 


For example: 


If you have the data input areas ZIP, STATE, and NAME on your entry form, you 
can specify that the report be ordered first by STATE, then ZIP, and then NAME. 
This is done by specifying the sequence for STATE, ZIP, and NAME as being 1, 
2 and 3, respectively. 
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Subtotaling is based on the first sort area defined. When the value in the first sort 
area changes when the report is produced that is the signal to print the subtotal 
group of lines. 


The order in which the report is produced defaults to ascending order. If you 
need the report ordered in descending order, then you must specify that it be 
produced in REVERSE order. This option can be selected for one or more data 
input areas that are defined for sorting. To specify reverse order, enter an “R’ 
below the data area name in the sort priority menu. 


CHARACTER SORT ORDER 


The following is a table describing the ascending order of characters. When 
sorting, lowercase letters are treated as uppercase. When indexing, uppercase 
comes before lower case. The list reads from top to bottom. 


space ' 8 D Pp \ h t 
! - 9 E Q J i U 
= : : F R “ j Vv 
8 / ‘ G S si k W 
$ 0 < H T ‘ L x 
h 1 = I U a m y 
& 2 > J V b n z 
P 3 ? K W C O { 
( 4 a L X d p | 
) 5 A M Y a q } 
* 6 B N Z f ‘i ad 
+ 7 0 C f S 


Step 4: DATA FROM OTHER FORMS 


As with DESIGN FORMs, you may reference data from other forms when 
creating a report using this option. Other forms refers to those forms that are not 
part of the same program unit. Select the data area used to reference the other 
form by placing the cursor on that area, and then press ctrl/B to specify the 
manner in which the area is to be used. 


A referenced area may be used to identify and find another form, or it may be 
used to output data once the other form is referenced. 


Note that once another form has been accessed by specifying an area as the 
link to the other form, any of the input areas in the other form may be used in 
computations without having to specify them as output areas on the report. 
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Once another form has been referenced, any area in the other form may be 
used in a FORMULA for an output area by specifying the other program or form 
name as the prefix in the formula. To use a data area from another form in a 
computational statement, specify the other program (form) name as the prefix to 
the data area name to be used, separating them with a period. 


For example: 


If an employee master form (EMPMAST) contains the pay rate (RATE) for an 
employee, and the form is referenced by an employee id number (EMPID), then 
the pay rate may be used in a formula by using the combined form and area 
names separated by a period as follows: EMPMAST.RATE. 


The formula may look like this: HOURS * EMPMAST .RATE 


The following prompts will be displayed: 


WHAT IS THE Enter the name of the other FORM containing the 
OTHER FORM information you wish to include in the report. 
NAME? 

DOES DATA IN Enter a “Y” to indicate that the data input/output area 
THIS AREA is to be used to identify a record from another form. 
IDENTIFY This creates the path which links the two forms. In this 
RECORDS FROM case, the area must also occur as an indexed area on 
ANOTHER FORM? the other form, and you must have used the same 
(Y/N) — name in the report you are designing. 


Enter a “N” to indicate you wish to use data from the 
other form in other output areas on the current form. 


Please see Chapter 3 for a in-depth explanation. 
Step 5: REPORT INSTALLATION 


The last step in report creation is to INSTALL your report. As with FORM 
creation, you may change a previously defined report at any time, but if you do, 
you must make sure to relNSTALL it if it has been changed. 


lf you try to produce a report before it has been installed, the following message 
is displayed: 


REPORT NOT The report you have selected was not located. In 

INSTALLED order to produce your report, you must INSTALL it 
first. Return to the DESIGN REPORTS program and 
install the report. 


wy 


General Reference 29 


PRODUCE REPORTS 
DISCUSSION 


The report production service lets you print out your reports. Enter the form 
name and select the PRODUCE REPORTS option. After naming the report to be 
produced, you may specify final report control definitions, if required. 


Selection of High and Low Ranges 


You may produce a report that includes only a subset of records (or FORMS) 
that have been added to the program data file. You may implement, or change 
the specifications before producing the report at any time using option 1 of the 
PRODUCE REPORTS menu. 


Report Title 


You may add a one-line title to the report at the time it is to be produced. A title 
may include a page number, the time of day, a date, or any other kind of 
information helpful in identifying the report. 


Number of Printed Lines on the Report Page 


You may change the number of lines you want printed on the report page. The 
number of lines specified here will include all printed lines of the report including 
the page HEADING, DETAILS, SUBTOTALS, TOTALS, and FOOTINGS. 


Number of Lines on the Report Page 


You may specify the total number of lines that are on the report page (starting 
from the first line on the top of the page to the last line on the bottom of the 
page.) This feature is used in the event that your printer is not equipped with an 
automatic feed (form feed). 


Designation of Report Destination 


Generally, reports are produced (or output) on paper using a printer. However, 
this is not the only way of producing reports. Other possible destinations of 
report output include output to the console screen and to a disk file. 


Number of Forms or Labels Across 


This feature is used in conjunction with fixed-type reports only. This option 
allows you to specify the number of labels (or report forms) that are to be printed 
from left to right on the report page. The minimum is one. The maximum Is 255 
divided by the width of each label. 
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Width of Each Label 


This option is used in conjunction with fixed-type reports only. The label (or 
report form) width specification directs the printer when to start and end printing 
each label. 


You may change the the label width at any time. 


Page Numbering 


You may designate the printing of page numbers on the report. To specify a 
page number you place four pound signs (####) in the desired spot on the 
report layout. This may be done by typing these pound signs as part of the 
report layout when designing the report, or by including them as a part of the title 
of the report when you are producing the report. 


If you define page numbering during the DESIGN REPORTS service, then you 
must reinstall the report if this feature is changed. 


Word Processing Reports 


You may produce a WordStar document (report) on a disk file. In this way, you 
may retrieve the document (report) later for text entry and editing and for 
inclusion with WordStar documents. You may use this option with other 
word processing software other than WordStar if desired. 


Multi-Up Output 
These two features relate to multi-up output of fixed-type reports only. 
@ You set up the number of reports (labels) across the page. 


® You set up the number of reports (labels) down the page. 


PROCEDURES FOR PRODUCING REPORTS 
The three functions are listed below: 
Step 1: SELECTION VALUES 


When this step is selected, the data input form is displayed. You may enter data 
into any area or combination of areas to set the low and high ranges of data for 
records which will be included in the report. If no data is entered, then no range 
is Set. 


This option allows you to produce a report that includes only a subset of records 
(or FORMS) that have been added to the data file. You may implement, or 


— 
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change the specifications before producing the report at any time using option 1 
of the PRODUCE REPORTS menu. 


The selection of a report range involves setting the LOW and HIGH values of 
data input areas on the program input FORM. Any or all of the data input areas 
that may be used for this purpose. 


For each data area selected, you may specify a LOW and/or a HIGH range for 
the values to be used. For example, if your program data file contains records 
with dates from 5/10/80 to 8/01/82, then you will be able to specify a report 
that includes only records with a date range from 6/03/81 to 7/ 04/82. 


Step 2: PRINT DETAILS 


Print details allow you to specify where the report is to be produced (i.e.,on a 
line printer, on the screen, or on a disk). You can also enter the width and length 
of the report pages, and the number of reports to be printed abreast on a page. 
You can also specify a title. 


TIE The title will be used on LIST or FIXED-type reports. If 
a title is entered, it will be printed at the top of each 
printed page. 


NUMBER OF The number you enter specifies the number of lines 

REPORT LINES which should be printed before skipping to the top of 
the next page. This is the number of printed lines 
output per page. 


This feature is used in conjunction with the NUMBER 
OF LINES ON THE REPORT PAGE to designate 
margins for the top and the bottom of the page. 


The number of printed lines may be changed at any 
time prior to producing the report. It does not require 
the reinstallation of the report. 


TOTAL LINES The total number of lines per page is the number 
PER PAGE between the top of the first page to the top of the next 
page. 
For Example: 


8 1/2 x 11-inch paper, 6 characters per inch equals 
66 lines per page. If your printer is equipped with 
automatic FORM FEED, you may leave the value at 0. 
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FILE NAME 
FOR REPORT 


Printer Output 
Console Output 


Disk File 
Output 


For output to the video display screen, the value would 
be the number of lines you wish to appear on the 
screen before pausing to allow for review of the 
Current page (i.e., 23) 


This feature may also be used to print more than one 
report page on a given sheet of paper. 


For example: 


If the number of lines to be printed on the sheet of 
paper is 66 lines per page, and you specify the 
number of lines on the report is 33, then the result is 
that two report pages will be produced on each sheet 
of paper. 


You may change this specification before you are 
ready to produce the report. You do not have to 
reinstall the report every time you change the spe- 
cified number. 


There are four possiblities for file names: printer 
output, console output, disk file output, and SuperCalc 
output. 


If you leave this area blank, your report will be printed 
on your line printer. 


If you enter ““CON:”, this means you wish the report to 
be routed to your video display screen. 


You may store your report on a file by specifying a 
valid CP/M file name, such as B:REPORT.DOC. In 
this case, your report will be stored on disk B, with the 
name given of REPORT.DOC. Selecting this option 
allows you to retrieve the report document for editing 
and/or printing using another program, such as 
WordStar. 


The special file type of .IDAT may be used to output a 
report without page breaks. This will suppress the 
Output of headers except for the first one, and the 
Output of footers. 


wo 


SuperCalc 
Output 


NUMBER OF 
FORMS OR 
LABELS 
ACROSS 


SINGLE FORM 
WIDTH 
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You may also use this option for SuperCalc spread- 
sheet reports. If your report is a SuperCalc spread- 
sheet, it will automatically be assigned the name of 
“TEMP.CAL”, unless you change it to a different 
name, such as “PROJECT.CAL”. 


This option allows you to print fixed-type reports multi- 
up. When you design a report layout to be printed 
multi-up, do so by laying out on the screen only one 
report and then specifying here the number of reports 
you want printed from left to right on a page. A good 
use of this capability is the printing of labels. 


You may change the number of labels to be printed at 
any time. 


This value specifies the number of columns wide 
each report is when multi-up reports are being printed. 


This value specifies the width of a single report (see 
above), expressed in the number of columns wide. A 
column is the space required to print a single char- 
acter. 


Step 3: FINAL REPORT 


Selection of Step 3 will cause the report to be produced. If the report is sorted 
the sort utility will be invoked and a message displayed. When the report is 
complete control returns to the service menu. 


To abort a report in progress use the escape key. 


Chapter 3 
Advanced Features 


MULTIPLE FORM PROCESSING 


PERSONAL PEARL provides you with the ability to create multiple program 
units that “share”, or transfer information. Information sharing is based on the 
DATA INPUT AREA NAMES, and the FORM NAMES of the program units 
involved. A program unit consists of a FORM and its associated REPORTs. 


Information sharing only occurs during the production of REPORTS, and the 
ENTRY of DATA. 


Information sharing is directional. This means that information can be trans- 
mitted between two program units in only one direction, one program unit sends 
and the other receives. Program units under execution (ENTER DATA, and 
PRODUCE REPORTS services) can only “receive” and process information 
from other external “sending” forms. 


Data from external forms is not affected by current input and editing functions. 
The data they contain is “write protected” against change and it Is “read only’. 
Program units that receive information may incorporate any data they receive. 
Incorporation includes the display, editing, and addition of such data to the data 
file of the program unit under execution. 


Information can only be shared between a maximum of 5 program units. This 
means that while you are executing one program unit, i.e., entering data or 
producing reports, you may access information from only 4 external forms. An 
attempt to access more than four (4) external forms will result in a special 
message during INSTALLATION. 


Information sharing cannot be circular. A program unit that accesses infor- 
mation from external program unit cannot provide information to those same 
program units. In addition, information may not be accessed from a form 
through an intermediate one. This means that form references must be direct. 


Only data input areas defined on external FORMS may be accessed from 
external program units. Data output areas defined on REPORTS are not 
available for sharing. 
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An external form must have an INDEXED data input area defined. This 
INDEXED data area is used by the program under execution to access the 
appropriate record. The INDEXED data area does not have to be unique (it does 
not have to reference one and only one record.) 


There is no limit to the number of data areas that may be shared between two or 
more program units. The program under execution has full use of all data areas 
on the external forms it accesses. In other words, all data areas become part of 
the information pool of the program unit under execution. 


The definition of information sharing occurs during the design of the FORM and 
the REPORT of the program unit that will receive data from external forms. 
External forms need not know that they are or will be sharing information. 


An external form must be completed and installed first before the receiving 
program unit is installed. All program units that share data must reside on the 
same program disk. If you set up a separate data diskette, then all data files 
must reside on one program data disk. 


Data is shared by referencing the data area name and the external FORM 
name. The first reference to an external form must be to the INDEXED data 
input area that will identify the record to be accessed. 


Shared data areas must have the same data area name and the same data 
area type. When a data area from an external form is used in a computational 
statement, then it must be prefixed by the other FORM name. An example would 
be CUSTOM.CHARGE where “CUSTOM’ is the name of the external form, and 
“CHARGE” is the data area name. 


Shared data that is not used in a computational statement should be defined 
separately as “DATA FROM OTHER FORMS”. 


Example: 


The following example shows the steps and the method used to create an 
information sharing path between an external or “sending” form called 
CUSTOM, and a receiving form called CHARGES. First, the external form is 
designed and then installed. This is followed by the design and installation of the 
receiving form. 


The external (sending) form (CUSTOM): 
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FORM LAYOUT 


PAAAAV ACSI AACS IAA AAI SAAR AAABA AAAI IA IDAP AAI DAA AAA AAS AAA AAA AAA AIR 
Customer Financial Master Form. 
Name 


Address 
Phone 


Charges: 


Credit $9.99 % 
Tax $9.99 % 


PA AIAAAAAAAAAAAAAAKAA AA AAA AAAI AAAAAAA AA AAAI AAI AAIAA ASAI AAI ICA 


FORM name: CUSTOM 
DATA INPUT AREAS: 


Name Type Index 
NAME C (character) non unique index 
ADDRESS C (character) none 
CHARGE N (number) none 
TAX N (number) none 
PHONE C (character) unique index 


The receiving form (CHARGES): 


The receiving form will access all the data areas defined for the form CUSTOM. 
The data accessed will be displayed, displayed and saved, or used in 
calculations. The NAME will be used to access the correct external record. 
ADDRESS, and PHONE will be displayed only. CHARGE, and TAX will be used 
in calculations. 
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FORM LAYOUT 


Jaidididdcdinidicidicddcciodcioiooicicioicicicicicticicicooicicictocicicietetcicicicicicieicick 


Current Charges Form 
For Customers 


Address 
Phone 


Charges: 
Credit $9.99 % 
tax $9.99 % 


PURCHASE AMOUNT $99,999.99 


Details: 
Credit charge $99,999.99 
Tax $99,999.99 


TOTAL $99,999.99 


Jeinididiidicididididididicicicicicicicicicioicioicicioiciciciciciicicicicteicicicieicicicicicicicicicicicicicicick 


Form name: CHARGES 


DATA AREA NAME: 


NAME 


This is the name of the data area that will be used to record the 
name of a customer. 


It is an INDEXED data input area. 


It is defined also as DATA FROM OTHER FORMS. In order for it 
to be retrieved from another form, it must also have the same 
data area name as that defined for the other external form. 


This data area is also used to identify records from the external 
form. No other data area name need be defined in this way. 


This data area must be of the same type (C) as that on the 
external form. 


Data for this area will be input by ENTERING DATA into the 
form CHARGES. 


ADDRESS 
PHONE 
CHARGE 
TAX 


AMOUNT 


ACHARGE 


ATAX 
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These data areas will contain the address, phone number, 
charge, and tax on credits and will be displayed only. 


They are not defined as INDEXED. 


They are of the same type as those data areas on the external 
form. 


You will not have to enter any data into the FORM for these data 
areas. The information will be automatically accessed and 
displayed from the external form. 


This data area is used to record the purchase amount. This 
data area is of TYPE Numeric, and it is required input. 


This is the service charge amount to be applied against the 
purchase amount. It is Numeric, and it is calculated. The 
calculation is as follows: 


AMOUNT* (CUSTOM. CHARGE/100) 


Where AMOUNT is the data area name for the amount of 
purchase. 


CUSTOM is the name of the external form from which CHARGE 
is accessed. 


Note the method of constructing the external data area refer- 
ence from the data area name and the form name. This is 
called the STANDARD EXTERNAL REFERENCE. 


Another way to write the same computation is: 
AMOUNT (CHARGE/100) 


Note that in this case, no reference was made to the external 
form name. This is only allowed if you have previously defined 
or used the data area on the same FORM or report. It will also 
be saved if it is defined on a FORM. 


When the calculation is complete, the amount is displayed. 
This is the tax to be applied against the amount. This data area 
is of type Numeric, and it is automatically calculated and 
displayed. The formula for calculation is as follows: 


AMOUNT (CUSTOM. TAX/100) 
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TOTAL This is the total cost to the customer of his or her purchase. It is 
calculated and then displayed automatically. The calculation 
Statement is as follows: 


AMOUNT+ACHARGE+ATAX 


COMPUTATIONS 


PERSONAL PEARL also provides you with the ability to create programs that 
Store and perform computations on data. Computations may be defined when 
you design either a FORM or a REPORT. 


Any Numeric data area on a FORM, or a REPORT, can have a computational 
Statement as part of its definition. The result of the computation can be 
referenced using the data area name. 


The computational statement should consist of one or more data area names 
(operands) and at least one operation character (operator). Four operation 
characters are available. The operational characters for SUBTRACTION, 
ADDITION, DIVISION, and MULTIPLICATION are “=”, “+”, "/" “x” respec- 
tively. 


Data area names used in computations must be defined first before they can be 
used in a computational statement. Computational statements may use data 
from other forms (i.e. external forms). 


Repetitive computations are provided on REPORTS. These are the calculations 
of TOTALS, and SUBTOTALS. 


The following is a detailed discussion of the rules and features associated with 
the use of calculations, and the construction of calculation statements. See also 
the Advanced Tutorial User’s Guide and Chapter 2 of this manual for examples 
and additional discussion. 


1. Calculation Statement Construction Rules. 


The following is a list of rules for constructing computational statements as 
they are defined for a data area. 


a. Four operational characters (operands) are available. The operational 
characters for SUBTRACTION, ADDITION, DIVISION, and MULTIPLI- 
CATION are “=", “+”, “7” “%”, respectively. 


b. Acomputational statement may contain numbers (constants), or data 
area names as operands. 
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For example: 


lf CHARGE and TAX are two data area names, then the computa- 
tional statement to compute the tax on the charged amount would be 
“ CHARGE*TAX/100” where “100” is the constant. 


A data area used in a computational statement cannot have a 
number as the first character of the data area name. 


For example: 

\llegal data area names: 3TAX, 123, SHATS, and 9HORSES. 
Legal data area names: TAX3, T123, HATS5, and HORSES9. 

A computational statement cannot start or end with an operator. 
For example: 


The computational statement “*1+3” is not correct because the 
statement started with a multiplication character. Similarly 
“ CHARGE*TAX100/ ” is also not correct because the last character in 
the statement is a division sign. 


The left and right parenthesis characters are used to specify seg- 
ments of computational statements (operations) that will be per- 
formed first. If you do not use parenthesis in your computational 
statements, then the divide and multiplication operations are per- 
formed before addition and subtraction. 


For example: 


The following two computational statements have the same results 
although they do not read the same way. 


Computation Result Reading the Statement 
3*4+5 17 three times four plus five 
3+ 3%4 17 five plus three times four 


By reading the second statement, you would think that the result 
should be 32 and not 17 because 5+3 is 8, and 8 times 4 is 32. 
However, the result is 17 because the multiplication part of the 
statement was performed first, and so the computation was per- 
formed as if the statement read “five plus the result of three times 
four’. In order to get the result of the second computational 
statement to be 32, it must be rewritten as (5+3)*4, and it would 
read: “multiply the result of five plus three times four’. 
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The number of right-hand parenthesis should always equal the 
number of left-hand parenthesis in a computational statement. 


The construction of statements within a left and right parenthesis 
must follow the same rules. 


For example: 


“6% (/ CHARGE*TAX/100)" and “CHARGE*2TAX/100” are not valid 
computational statements. 


f. A computational statement may be constructed using data area 
names from other forms. These data area names must be prefixed by 
the name of the other ‘external’ form and a period. 


For example: 


If the other form name is CUSTOM, and the data area name is 
CHARGE, then the computation statement should refer to the data 
area “CHARGE” as CUSTOM.CHARGE. 


Computational Statements and Report Subtotals. 


Subtotal computational statements are a special case of computational 
Statements, and are used only in list and SuperCalc-type reports. In order 
to print a subtotal, you must define a new data area. The definition should 
also include a computational statement. The computational statement 
should start with the new data area name as the first operand. It should 
then be followed by a +", and the data area name (or names) of the data 
area(s) that are to be subtotaled. 


A subtotal statement will be printed every time the value of the first sort 
priority data area changes. 


An example would be if the data areas “CHARGE”, and “TAX” are to be 
subtotaled for each customer on a periodic transaction report. The subtotal 
is to reflect both the charge and the tax. First, make sure that “CHARGE” 
and “TAX” have been defined on the report. Second, define the subtotal 
data area with the data area name “SUBTOT”, and the computational 
statement ‘“ SUBTOT+CHARGE+CHARGE*TAX/100”. 
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Report example sdistndinddnininndnnidnidi didi ddI Ia IAAI AIK 
Charge Tax 


customer 23-12 $100 $10 
$60 $6 
$1000 $100 

Subtotal $1,276 


PAAAAADAAAAAAA AAA AAA AAA AAAAAASAAADAAASAASAAASAAAASASAA AH IK 


Note that only LIST and SuperCalc-type reports provide for the definition of 
subtotal statements. These subtotal statements are executed only when 
the report is sorted, and the data content of the first sort priority data area 
has changed. 


For example: 


lf the customer number was chosen as the first sort attribute of the report 
mentioned above, then any subtotal statements defined will be executed 
when the customer number changes as the report is being produced. 


Computational Statements and Report Totals. 


Total computational statements are a special case of computational 
statements, and are used only in reports. In order to print a total for a report, 
you must define a new data area. The definition should also include a 
computational statement. The computational statement should start with 
the new data area name as the first operand. It should then be followed by 
a+” and the data area name (or names) of the data area(s) that are to be 
totaled. 


For example: 


The data areas “CHARGE” and “TAX” are to be totaled for a periodic 
transaction report. The total is to reflect both the charge and the tax. First, 
make sure that “CHARGE” and “TAX” have been defined on the report. 
Second, define the total data area with the data area name “TOT” and the 
computational statement “ TOT+CHARGE+ CHARGE*TAX/ 100”. 
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Report examoLle olididldldldiciciciciciciiciciciciciciciciciciciccictctctcictctcicicick 


Charge Tax 

customer 23-12 $100 $10 
$60 $6 

$1000 $100 


Subtotal $1,276 


customer 23-13 $900 $90 
$40 $4 
Subtotal $1,034 


Total $2,310 
tnidddidicinidicicicicinicicicicicicicicicicicicictcinicinicicicicicicicicjojcicicieticicictetcicictoticick 


Note that only LIST and SuperCalc-type reports provide for the definition of 
total statements. Total statements are executed at the end of the report. 


4. SuperCalc Reports and Computational Statements. 


Computational statements defined on a SuperCalc-type report are not 
transferred to the SuperCalc spreadsheet. Only the results of calculations 
are transferred to spreadsheet cells. For more information on working with 
SuperCalc, please refer to the General Reference, Chapter 2 and Appen- 
dix H. : 
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MULTIPLE RECORD TYPES AND CONTROL INFORMATION 


Many applications lend themselves to a structure where information in several 
formats resides in the same file. For example: A factory may keep one kind of 
employee record for factory workers and another for management workers and 
require both kinds of records in the same report. This then is a program with 
mixed record types. The two types of employee records can be, in the context 
of PERSONAL PEARL, variations of one data input form. 


The use of mixed record types can allow for a single data input form to handle 
more than one type of entry. This simplifies input because data can be batch 
input without changing forms. 


Flexibility is added to report design for files with mixed record types since the 
mixed types may be listed together, or separated into groups using report 
selection values. 


The same architecture which provides the means of mixed record typing also 
allows for associating control information with record types, both numeric and 
textual, which are not displayed on the data input form. 


Multiple record typing, in general, requires that the various types of records 
have a similar structure. That is, the two types of data input forms have about 
the same number of character input areas and numeric input areas, arranged in 
the same places on the form. The two types need not be exactly the same, as 
unneeded areas in one type may be left unused without disk storage overhead. 


CONTROL MASKS 


PERSONAL PEARL supports multiple record types through the use of “control 
masks”. A control mask is simply a name given an external form with only a few 
records (usually just two or three) used to modify the main form. The 
modifications take the form of changing the prompts for the various data areas 
and supplying numeric coefficients for computations associated with the type. 


The technique is based on PERSONAL PEARL’s ability to create an input form 
that shares data from an external form, as discussed in Chapter 2 of the 
Reference Manual. During data entry, when the access key to the external 
Mask form is entered, all the data associated with the access key is displayed in 
the main form. 


An example of a simple Accounts Payable system follows to illustrate this 
technique for you. The Journal of the system has two types of entries: invoices 
and checks. This is a good use of multiple record typing because the two types 
have a similar structure, i.e., they both have a date, a vendor, an amount, etc. 
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The two types differ slightly in that invoices have an “expense distribution 
class’, and checks do not. We will use a message stored in the “C” record of 
the control mask form in order to inform the operator to ignore the expense 
distribution class area when entering a check. 


Refer to the form layout reports following this example for details on the design 
of the Journal and its control mask. We will now proceed to sketch the process. 


Main Journal Data Entry Form 


Journal entry number : 999 

Entry type : — ( I for invoice, C for check ) 
number : 
date : mm/dd/yy 
——__—. amount : 999,999.99- 

Vendor : 
Memo : 
: 99 


Journal Control Mask Form 


Entry type: — (I for invoice, C for check ) 
Number area promot: ——— 
Date area prompt: —— 
Amount area promot: ——— 
Expense area promot: 


Invoice coefficient: 9 (1 if invoice, 0 if check ) 
Balance coefficient: 99 ( -1 if check, 1 if invoice ) 


The coefficients shown in the above control mask will be used later when 
designing reports, and we will return to them later in the section. 


DESIGN STEPS 


Li 


Design the control mask first. 
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e The Entry type is a one character input area. 


@ = It is the only index for the mask. 


e It has been defined as a unique index. 


Install the mask and then, 


% Go to the enter data service. 
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@ Enter aC type record and an | type record into the file. The data for 


the two records is shown below. 


The result is as follows: 


Number 
Date 
Amount 
Expense 


Invoice 
Balance 


Number 
Date 
Amount 
Expense 


Invoice 
Balance 


Journal Control Mask for Type | (Invoices) 


Entry type: I ( I for invoice, C for check ) 


area prompt: Invoice 
area prompt: Invoice 
area prompt: Invoice 


area prompt: Expense class 


coefficient: 1 (1 if invoice, 0 if check ) 
coefficient: 1 ( -1 if check, 1 if invoice ) 


Journal Control Mask for Type C (Checks) 


Entry type: C (I for invoice, C for check ) 


area prompt: Check 
area prompt: Check 
area promot: Check 


area promot: Enter 0 here. 


coefficient: 0 (1 if invoice, 0 if check ) 
coefficient: -1 ( -1 if check, 1 if invoice ) 
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Note that the word “Check” was right-justified wnen we entered the C type 
record above. The reason for this will be apparent when the word is 
displayed in the journal form prompt area. 


Design the Journal next. 

@ The journal needs to access the control mask form. Therefore, define 
the prompt areas in the journal form with the same names and 
lengths as the corresponding areas in the control mask. 


@ Then, use Step 4 of the design process to set the type as the link or 
path to the mask, and 


@ Define the prompts as display only areas. 
Install the Journal and then, 
@ Goto the enter data service and add a journal record. 
@ When the form is displayed for data entry: 
Enter journal entry number one, then, 
Enter | for invoice. 
Note that when the | is typed, no return is necessary for the mask to be 
accessed. The cursor advances to the next field. The screen will appear as 


follows. 


Main Journal Data Entry Form 


Journal entry number: 1 
Entry type : I ( I for invoice, C for check ) 
Invoice number : 
Invoice date : —__ 

Invoice amount : 

Vendor : 

Memo : 

Expense class : —— 
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@ = Fill in the remainder of the form and enter the record. 
Now, try check entry on Journal entry number two. 


@ When the C is entered for type, the mask for check entry will be 
accessed and the screen will appear as follows: 


Journal entry number: 2 
Entry type : C ( I for invoice, C for check ) 
Check number : ¢ 
Check date: 2 ccc 
Check amount : 
Vendor : 
Memo : 
Enter 0 here. : —— 


Note the message to enter O for the expense type. By the use of the invoice 
coefficient, we can zero out this value on subsequent reports, regardless of 
what is entered in this area. In this way, we make the expense Class area a 
“don't care’ area on check entry. 


Design the Vendor Ledger Report. 


This report sorts the journal by vendor, by date, and by journal entry 
number. The report shows the amount of each entry and keeps a running 
balance by using the balance coefficient in the control mask. The vendor 
ledger can be designed as follows: (Refer to the layout report at the end of 
this chapter for details on the design.) 


Vendor Ledger 
Entry Type Number Date Amount Balance 
11 I Invoice 3456 7/2/82 102 .30 0.00 
22 I Invoice 3567 7/4/82 75.50 102.30 
27 C Check 12 7/12/82 177 .80 177 .80 


Amy's Business Supplies Current Balance 0.00 
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Note that the type appears on the report. Once again, this area is used to 
access the control mask. The data used from the mask in this report is the 
Number prompt which supplies the word “Invoice” or “Check” and the plus 
one (1) or minus one (-1) of the balance coefficient used in keeping the 


running balance. 


In general, when moving an application to production status, you will want 
to remove the mask program from the form directory, while leaving the files 
intact on disk. This will leave the directory uncluttered for the operator and 
prevent unwanted editing of the control masks. 


DIRECTORY MAINTENANCE 


PERSONAL PEARL maintains a form directory and a varying number of report 
directories, depending on the user’s system design. The directories provide 
features and functions permitting a variety of uses. The most important use of 
the directory is to control operator access to particular forms and reports. 


FORM DIRECTORY 


For a PERSONAL PEARL system, there is a form directory, and in it are the 
forms or program units available to the operator. This directory is represented 
on disk as the file PEARL.DIR. A program unit is a data entry form and any 


number of reports. 


Adding entries 


Deleting entries 


Entries are added to the form directory when an 
attempt is made to access a form that is not in the 
directory. When this occurs, PERSONAL PEARL will 
display a message that the form is not located and 
offer to ADD the form. When a form is added to the 
directory, the user is prompted to enter a description 
of the form, which also appears in the directory. 


When the form is added to the directory, the disk files 
which comprise a program unit are not created until 
the the design forms process is performed. 


Program units may be deleted from a PERSONAL 
PEARL generated system at two levels. The program 
unit may be deleted from the directory by deleting the 
program unit form name, yet still exist as disk files, or 
the form may be removed from both the form directory 
and from the disk. 


c™ 


Changing Form 
Names 
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To delete a form from the directory, enter the name of 
the form. Then, instead of pressing RETURN, enter 
ctrl/O. PERSONAL PEARL will respond with the mes- 
sage “OK TO DELETE?”. You enter “Y” or “N”. If Y is 
entered, the form will be removed from the PEARL 
directory. 


At this point, the program unit is still in existence on 
disk but may not be selected from the directory. The 
program unit and its data may be accessed as an 
external form by other forms and reports. The program 
unit may also be restored to the directory using the 
PEARLDF program by adding the form name to the 
directory in the usual manner. 


To delete a program unit entirely from the system, it is 
necessary to both delete the form from the form 
directory and from the CP/M disk directory. To delete 
the program unit from the CP/M directory use the 
CP/M ERA command. 


Form names may be changed only in certain situ- 
ations. Once a report has been defined for a given 
form, if the form is renamed, the report is no longer 
usable. The result then is that forms may be renamed 
at the cost of losing existing reports which access the 
form. 


To rename a form, use the CP/M command REN to 
rename the files associated with the form to the new 
names with the same file types as the originals. The 
new name must be seven characters or less. The old 
form name is then deleted from the form directory and 
the new name added. 


REPORT DIRECTORIES 


Reports designed with PERSONAL PEARL are associated with a particular 


form. For each form with associated reports, there is a disk file HONEY.DIR, 
where “HONEY” is the name of the form. This file contains the directory of 


reports available to the operator. 
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Adding Entries 


Deleting Entries 


Changing Report 
Names 


To add an entry to the report directory, type in the 
name of the report. If PERSONAL PEARL cannot 
locate the report in the directory, the message “NOT 
LOCATED - ADD?” will be displayed. Enter “Y” for 
yes, and the report will be added to the directory. The 
New Report options will then be displayed. 


To delete an entry from the directory, type the name of 
the report and hit ctrl/O rather than RETURN. The 
message “OK TO DELETE?” will be displayed. Enter 
“Y” for yes, and the report will be removed from the 
directory. At this point, the disk files which comprise 
the report still exist on disk. To remove the report from 
the system entirely, use the CP/M command ERA to 
delete the files from the CP/M directory. A report 
which has been deleted from the report directory, but 
whose files are still on disk, may be restored by using 
the design reports service to add the report back to 
the directory with the same name. 


To change the name of a report, create a new report 
with the desired new name. Select the new report 
option to copy an existing report. Next, delete the 
original report from the directory, and delete the 
associated files from the CP/M directory. 


AUTOMATIC CURSOR POSITIONING 


PERSONAL PEARL has an automatic sequence for positioning the cursor 
during update processing. That is, during add processing, as data is entered 
into the form, the cursor moves ahead from field to field in a consistent fashion, 
depending on the design if the input form. Associated with the automatic motion 
of the cursor is the triggering of access to external forms and the computation of 
computed data areas. We will make some general statements about automatic 
cursor motion, then offer some techniques for making use of and controlling the 


cursor behavior. 


1. The cursor moves from input area to input area, from left to right, top to 


bottom. 


2. When characters have been added to an area until the area is completely 
full, the cursor will jump to the start of the next input area, without requiring 
a return to be entered. 
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3. When the RETURN is pressed, the cursor will jump to the next area. 


4. If a data area is a “display only” area which is brought in from another file, 
the cursor will not pause on the area, but will continue to the next input 
area. 


©. When the cursor jumps out of a data area, two automatic processes are 
triggered. 


e First, computations which involve the data area, if any, will be 
recomputed. 


@ Second, if the data area is an access key or path to an external form, 
then the external form will be accessed, and any data from the 
external form which is to be displayed elsewhere on the current form 
will be displayed. 


6. If a data area has been brought in from another form, but not as a display 
only area, then the cursor will pause on that area for editing in the same 
manner as other data input areas. 


7. When the cursor jumps out of the last data area on the screen, if there are 
more pages defined in the form, then the next page of the form will be 
displayed and the cursor will be positioned on the first data area of the 


page. 


8. When the cursor jumps out of the last data area of the form, one of two 
things will occur. 


e If the data area is a computed numeric area, then the computations 
will be refreshed, and the cursor will be positioned to the first data 
input area on the page. 


e If the last data area of the form is not computed, then the record will 
be automatically added to the file, and the cursor positioned to the 
Start of the form, ready for the next record to be input. 


CONTROLLING THE CURSOR 


Two kinds of dummy data input areas may be used to control the automatic 
motion of the cursor without resulting in disk overhead. One area will allow the 
cursor to pause, and the other will force the cursor to move. 
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CURSOR PAUSE 


CURSOR SKIP 


To provide a place for the cursor to pause during data 
entry, define a one character input area as a non- 
index, not required area. It is often convenient to have 
the cursor pause next to messages for the operator, or 
at the bottom of the input page. 


The cursor skip area can be used to force the cursor 
from the last input area of a form to the first input area 
on the last page of the form. 


Define a cursor skip area as a one digit, computed 
numeric area, and compute the area as a constant 
amount, i.e, 10. PERSONAL PEARL will attempt to 
display the number ten in the input area which Is only 
one digit long. This will cause an overflow condition to 
which PERSONAL PEARL respond by displaying an 
asterisk, and positioning the cursor to the top of the 


page. 
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FORM LAYOUT (PAGE 1) FOR MASK 


JOURNAL CONTROL MASK 


Entry type: 1 ( I for invoice, C for check ) 
Number area promot: ————2 

Data area promt: —— 3 
Amount area promot: 4 


Expense area promot: —__5 
Invoice coefficient: 6 ( I if invoice, 0 if check ) 
Balance coefficient: -7 ( -1 if check, 1 if invoice ) 


INPUT AREA ATTRIBUTES: 


1 


DATA AREA NAME: MI 

DATA AREA TYPE: CHARACTER 
1 

REQUIRED DATA 

DATA AREA IS UNIQUE INDEX 


DATA AREA NAME: MN 
DATA AREA TYPE: CHARACTER 


1234567 
DATA AREA NAME: MD 
DATA AREA TYPE: CHARACTER 


1234567 
DATA AREA NAME: MA 
DATA AREA TYPE: CHARACTER 


1234567 

DATA AREA NAME: ME 

DATA AREA TYPE: CHARACTER 
1234567 


DATA AREA NAME: MIC 
DATA AREA TYPE: CHARACTER 


1 
DATA AREA NAME: MBC 
DATA AREA TYPE: CHARACTER 


12 
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FORM LAYOUT (PAGE 1) FOR JOURNAL 


ACCOUNTS PAYABLE JOURNAL 


Journal entry number; — 
Entry type: 2 ( I for invoice, C for check ) 
eee. eS: a 
Se eo! | | ee 
ee! eo 0; | re | 
So) 22, A a TL ET 
8 ee aS RL TN | I 
‘simian 1a Ve 


INPUT AREA ATTRIBUTES: 


1 DATA AREA NAME: JE 
DATA AREA TYPE: NUMBER 


299 

123 

REQUIRED DATA 

DATA AREA IS NON UNIQUE INDEX 


2 DATA AREA NAME: MI 
DATA AREA TYPE: CHARACTER 
1 
REQUIRED DATA 
FORM: <MASK> ACCESS KEY 


3 DATA AREA NAME: MN 
DATA AREA TYPE: CHARACTER 


1234567 
FORM: <MASK> DISPLAY ONLY 


& DATA AREA NAME: JNUM 
DATA AREA TYPE: CHARACTER 


123456 
REQUIRED DATA 


5 DATA AREA NAME: MD 
DATA AREA TYPE: CHARACTER 
1234567 
FORM: <MASK> DISPLAY ONLY 


ao 


10 


11 


12 
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DATA AREA NAME: JDATE 
DATA AREA TYPE: DATE 
mm/dd/yy 

12345678 

REQUIRED DATA 


DATA AREA NAME: MA 
DATA AREA TYPE: CHARACTER 


1234567 
FORM: <MASK> DISPLAY ONLY 


DATA AREA NAME: JAMOUNT 
DATA AREA TYPE: NUMBER 


299.997 .77- 
12345678901 
1 


REQUIRED DATA ~ 


DATA AREA NAME: VENDOR 
DATA AREA TYPE: CHARACTER 


123456789012345678901234567890 
1 i 

DATA AREA NAME: JMEMO 

DATA AREA TYPE: CHARACTER 

123456789012345678901234567890 
1 2 3 

DATA AREA NAME: ME 

DATA AREA TYPE: CHARACTER 


1234567 
FORM: <MASK> DISPLAY ONLY 


DATA AREA NAME: EXPENSE 
DATA AREA TYPE: NUMBER 


pad 
123 


of 
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REPORT NAME: VLEDGER, FORM NAME: JOURNAL 


Vendor Ledger 
Entry Type Number Date Amount Balance 
<BLANO 
DETAIL 
‘iad re LE eee LS a a ee ae oe 
SUBTOT 


Le ae ee 
<BLANK> 
<BLAN 
REPORT DESCRIPTION: Vendor Ledger 
REPORT TYPE: LIST 
SORT SEQUENCE: VENDOR.JDATE.MI- 
REPORT OUTPUT AREA ATTRIBUTES: 
1 DATA AREA NAME: JE 
22 
123 
2 DATA AREA NAME: MI 


1 
3 DATA AREA NAME: MN 


1234567 
FORM: <MASK> PRINT/DISPLAY ONLY 


4& DATA AREA NAME: JNUM 
123456 
5 DATA AREA NAME: JDATE 


MM/DD/YY 
12345678 
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DATA AREA NAME: JAMOUNT 
999 999 .99- 
12345678901 

1 


DATA AREA NAME: RBAL 
999 999 .99- 
78901 
1 


DATA AREA NAME: VENDOR 


12345678901 2345678901 2345678901 2345 
1 2 3 


DATA AREA NAME: BAL 
999 999 .9- 
12345678901 


1 
COMPUTATION:BAL + ( JAMOUNT * MASK.MBC ) 
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Chapter 4 
Layout Reports -- Design Aids 


INTRODUCTION 


The DESIGN FORMS and DESIGN REPORTS services of PERSONAL PEARL 
will give you quick layout reports on the design work that you have completed 
on a form or report. The reports are called LAYOUT REPORTS, and they are 
produced on paper using the line printer. They are especially valuable for your 
own consideration and proofing purposes and are invaluable if you want to 
share what you are creating with other people who may have important ideas to 
contribute. 


The LAYOUT REPORTS are produced in condensed form, and it is the purpose 
of this section to show you how to interpret them. 


In order to produce a LAYOUT REPORT for the FORM or the REPORT that you 
have designed simply type a ctri/P while in the FORM LAYOUT, or the 
REPORT LAYOUT step (1) of the DESIGN FORM, or DESIGN REPORT 
services, respectively. 


LAYOUT REPORTS are produced in two sections. The first is simply a 
duplication of the FORM, or REPORT design layout as it appears on the screen. 
The second consists of a condensed listing of the data areas that have been 
defined, and the associated attributes (semi-technical data). The following is a 
discussion of LAYOUT REPORTS and their interpretation. 


DESIGN FORM (layout reports) 


One report will be produced for each page defined for the FORM. If your FORM 
consists of more than one page, each must be reported separately by bringing 
that page on-screen and entering ctrl/P. 

Given that you have designed a FORM called CLIENT as follows: 


NAME 
AGE 999 


Then a LAYOUT REPORT will be produced in two sections. 
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The first section will be a reproduction of the FORM as it appears on your 
console screen with the data input areas numbered from left to right, and top to 
bottom as follows: 


FORM LAYOUT (PAGE 1) FOR CLIENT 


AGE 2 


The second section will list in condensed format the attributes that you have 
defined for each data input area. The attributes of the data input areas will be 
listed in order by the data input area number as designated on the first section 
of the report as follows: 


INPUT AREA ATTRIBUTES: 


1 DATA AREA NAME: NAME 
DATA AREA TYPE: CHARACTER 


12345678901 234567890 

1 2 
REQUIRED DATA 
DATA AREA IS UNIQUE INDEX 


DATA AREA NAME: AGE 
DATA AREA TYPE: NUMBER 


nN 


123 


Data area attributes consist of the answers you gave to the questions presented 
to you when defining the FORM LAYOUT, DATA AREAS, INDEXED DATA 
AREAS, and DATA FROM OTHER FORMS. They are listed for each data area 
in the same order the design steps are ordered. Only applicable attributes are 
listed. For instance, if a data area is not an INDEX, then its list of attributes will 
not include any mention of indexing. 
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The following is a sample listing of attributes for a data area, anda description of 


each attribute. 


DATA AREA NAME: NAME 


DATA AREA TYPE: CHARACTER 


12345678901 234567890 


1 2 


REQUIRED DATA 


COMPUTATION: CHARGE*TAX 


DATA AREA IS UNIQUE INDEX 


FORM: <CLIENT> 


This is the first statement to appear for each 
data area. The data area name is “NAME”. 
This line will always be included in the report. 


The data area type options are CHARACTER, 
NUMBER, or DATE. This line will always be 
included in the report. 


This indicates the length of the data area. The 
data input area in this example is 20 char- 
acters long. This line will always be included 
in a report. 


This line will be printed if you answered Yes to 
the question “IS DATA IN THIS AREA 
REQUIRED”: otherwise, it wiil not be printed 
and you can assume that the data is not 
required. 


This line will contain the computational state- 
ment defined for the data area. If you did not 
specify a computational statement, then it will 
not appear on the report for the data area. In 
this example, the computational statement is 
“ CHARGE*TAX ”. 


This line will be printed if you defined the data 
area as indexed, and if it identifies one and 
only one record on the data file. If it does not 
identify one and only one record, then the line 
will say “DATA AREA IS NON UNIQUE 
INDEX”. If this data area is not defined as 
indexed, then this line will not be printed. 


This line will be printed if the data in this data 
area is to be defined as coming from another 
form. In this case, the other form name is 
“CLIENT”. If the data is to be displayed on the 
screen only and not added to the data file, 
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then the message “PRINT/DISPLAY ONLY” 
will be added. If the data area is used to 
access the other form’s record, then the 
message “ACCESS KEY” will be added. This 
line will not be printed if the data is not from 
another form. 


DESIGN REPORTS (layout report). 


One report will be produced for each page defined for the REPORT. If your 
REPORT consists of more than one page, then you must position to each page 
and enter a ctrl/P. Multiple-page reports are a characteristic of only FIXED-type 
reports. 


Given that you have designed a REPORT for a form called CLIENT, where the 
report name is “CLIENTR”, the report type is FIXED, and the report is to be 
sorted by “NAME” first, then by “AGE”. 


NAME 
AGE 999 


Then a LAYOUT REPORT will be produced in two sections. 


The first section will be a reproduction of the REPORT as it appears on your 
console screen with the data input areas numbered from left to right, and top to 
bottom as follows: 


REPORT NAME: CLIENTR, FORM NAME: CLIENT 


AGE —2 


REPORT DESCRIPTION: CLIENT ID REPORT 
REPORT TYPE: FIXED 
SORT SEQUENCE: NAME.AGE 
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The second section of the report will list in condensed format the attributes that 
you have defined for each data input area. The attributes of the data input areas 
will be listed in order by the data input area number as designated on the first 
section of the report as follows: 


ae 


INPUT AREA ATTRIBUTES: 


\ 


1 ‘DATA AREA NAME: NAME 


12345678901234567890 

1 2 
REQUIRED DATA 
DATA AREA IS UNIQUE INDEX 


2 DATA AREA NAME: AGE 
125 
i 


Data area attributes consist of the answers you gave to the questions presented 
to you when defining the REPORT LAYOUT, DATA AREAS, SORT PRIORITIES, 
and DATA FROM OTHER FORMS. They are listed for each data area in the 
same order the design steps are ordered. Only applicable attributes are listed. 


The following is a sample listing of attributes for a data area, and a description of 
each attribute. 


DATA AREA NAME: NAME This is the first statement to appear for the 
data output area. The data area name is 
“NAME”. This line will always be included in 

the report. 


12345678901 234567890 : 

1 2 This indicates the length of the data area. The 
data output area in this example is 20 char- 
acters long. This line will always be included 
in a report. 
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COMPUTATION: CHARGE*TAX 


FORM: <CLIENT> 


This line will contain the computational state- 
ment defined for the data area. If you did not 
specify a computational statement, then it will 
not appear on the report for the data area. In 
this example, the computational statement is 
“ CHARGE*TAX ”. 


This line will be printed if the data in this data 
area is to be defined as coming from another 
form. In this case, the other form name is 
“CLIENT”. If the data is to be displayed on the 
screen only and not added to the data file, 
then the message “PRINT/DISPLAY ONLY” 
will be added. If the data area is used to 
access the other form’s record then the mes- 
sage “ACCESS KEY” will be added. This line 
will not be printed if the data is not from 
another form. 
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Chapter 5 
File Maintenance Program - PEARLFM 


INTRODUCTION 


The PERSONAL PEARL file maintenance utility (PEARLFM) provides the ability 
to perform three distinct types of services: you Can recover unused disk space 
in the data file; you can rebuild the index to a data file if there are changes in the 
form design or an external malfunction (as with a power failure); and you can 
maintain separate development (design) and production disks. 


In order to perform these three services, six program functions are provided as 
follows: 


Function 1 Provides statistical information on the file, including the size on the 
disk, number of records, and the amount of unused space. If 
significant unused space is present, you would use the COM- 
PRESS function described below to reclaim the space. 


Function 2. Rebuilds the index when you add or change the indexing of a form 
through redesign. 


Function 3 Compresses the data file which will recover any unused disk 
space. Unused disk space can accumulate as a result of extensive 
editing of the file. This function may also be used to validate and 
restore data integrity in the event of an external malfunction. 


Function 4. Creates new data files on a separate production disks 


Function5 Transfers form changes from development disks to production 
disks when production disks are maintained separately. 


Function 6 Transfers program changes to apply form and report design 
changes to production disks when production data files are being 
maintained separately from the development disks. 


In general, functions 4, 5 and 6 are used only when separate development and 
production disks are being maintained. The most often used function during 
design work with PERSONAL PEARL is “rebuilding the index”. This is required 
when indexed areas are added or removed from a previously designed form. 
You will be notified by PERSONAL PEARL with a message if this type of file 
maintanence is required. 
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PROGRAM OPERATION 


When you enter the File Maintenance Program, the Form Directory will be 
displayed. Select the form on which file maintenance is to be performed. When 
a form has been selected, the file maintenance functions will be displayed as 
follows: 


1: FILE SUMMARY DATA 4: CREATE DATA FILE 
2: REBUILD INDEX 2: TRANSFER FORM CHANGES 


3: COMPACT DATA FILE 6: TRANSFER PROGRAM FILES 


FILE MAINTENANCE MENU 


Form Name: ADDRESS 
SELECT A SERVICE NUMBER: 


Press RETURN to continue, ? for HELP, or ESC to EXIT 


You would select the desired function by number. 
1. FILE SUMMARY DATA 


These messages will be displayed on your screen when you select 
Function 1. 
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SUMMARY FILE DATA FOR: ADDRESS .DOO 
NUMBER OF RECORDS= 3 
FILE VERSION NUMBER= 1 
NUMBER OF DATA FIELDS= 6 

SPACE AVAILABLE IN DATA DICTIONARY= 2395 

SPACE REMAINING ON DISK= 644K 
UNUSED SPACE= OK 
DATA FILE SIZE 5K 


HARD COPY (Y/N 


You may press “Y” to get a print out on your printer of these statistics or “N” if 
you do not want a print out. 


These messages are described below as follows: 

SUMMARY FILE DATA FOR: xxxxxxx.D00 

This is the name assigned to the data file. 

NUMBER OF RECORDS =nnnn 

This is the number of forms currently on the file. If a system failure occurred 
during an ENTER DATA process, this will probably be the number of forms at 
the time the process started, and will not reflect new records added prior to the 
failure. 

FILE VERSION NUMBER=nnnn 

This is the number of times the form has been installed. 


NUMBER OF DATA FIELDS=nnnn 


This is the number of currently active input areas on the screen. 
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SPACE AVAILABLE IN DATA DICTIONARY=nnnn 


This is the number of available bytes (characters available for expansion of the 
data dictionary). New input areas may be defined on the input form until this 
Space is exhausted. 


SPACE REMAINING ON DISK=nnnn 


This number times 1024 (1,024 bytes = 1 kilobyte, or 1K) is the number of bytes 
available for expansion of the data on the data disk. This same information may 
be obtained through the use of the CP/M STAT commana. 


UNUSED SPACE=nn 


This number times 1024 is the number of unused bytes on the data file due to 
the deletion of data records. 


DATA FILE SIZE=nnnn 


This number times 1024 is the number of bytes used on the data file for the 
form. This includes the space for the data dictionary which may require 4 to 12K 
when the form is initially installed depending upon the number of input areas on 
the input form. 


2. REBUILDING THE INDEX 


Function 2 will rebuild an index for the data file of the form specified. Use of 
this service is required: 


a. If your computer has failed during the enter data phase of processing. 


b. | When you have changed a form to include additional indexed areas, 
or when you have deleted indexed areas from an existing form. 


The percentage of index remaining to be built is displayed at the lower 
right-hand side of your screen. Rebuilding an index may take from less 
than a minute on a small data file up to more than an hour for data files 
consisting of several thousand entries. Forms that use more indexed data 
entry areas require more time to be processed than others that have fewer 
indexed data areas. 


3. COMPACT DATA FILE 


Function 3 will rebuild the production data file. This service is used when 
required by procedural steps specified in the manual or when you need to 
optimize the amount of free storage space on the production diskette. 


This service creates a new data file on the program diskette (or production 
data diskette). The new copy of the data file should be smaller (or more 
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compact). This is especially true when a considerable amount of editing 
and deleting of forms has taken place. During the compaction process, 
data for any data fields which have been deleted from an update form or 
renamed on the update form will be deleted from the data file. 


This service requires some free space on the program diskette. The 
amount of free space required depends on the size of the data file that is to 
be rebuilt. This service will look for free space on the available disk drives. 
You may be asked to place a “blank” diskette on the PERSONAL PEARL 
disk drive (or another work drive if available). 


CREATE DATA FILE 
Function 4 will create a blank data file into which you may enter data. 


This service will be requested by other procedures in the manual or when 
the following situations occur. 


a. When your data file (generally on a production diskette) becomes too 
large and you have approached the maximum number of records or 
forms that can be stored on it. In this case, a new data file ona 
separate disk can be created. To do so, follows these steps: 


1) Make a copy of the program diskette on which the data file 
resides; 


2) Mark the copy as the new program diskette, 
3) Place the new copy on the program disk drive, 


4) Then execute this option. When requested to place the develop- 
ment diskette on drive A (the copy source drive) place either the 
development diskette, or the original copy of the data file on A. 


Note that using this process would allow you to re-initialize a single 
file in a set of files without changing the other files during the process. 
This would be convenient in the case where one of the files on your 
program diskette is a MASTER file which contains data which is 
needed from one month to the next, but another file is a transaction 
file which contains only those transactions which occurred during the 
month, and you want to create a new file at the beginning of each 
month. 


b. When you want to set up a production diskette from a development 
diskette. Generally, a program is tested with real data before it is 
actually used in production (production mode). This is done by adding 
records or forms to the data file, and checking the results. This 
service will get rid of all the test data that was added. 
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Cc. Some special messages do require that the data file be cleared 


before changes may be installed. These Special messages are 
associated with the program development process. 


TRANSFER FORM CHANGES 


Function 5 is used to update or transfer changes made to the form from the 
development diskette to the production diskette. This transfer effects only 
the data file and does not effect any data added to the data file. If a data file 
is not found on the production diskette (or on the diskette in the program 
disk drive), then processing will terminate without completing properly, so 
be sure that your production and your development diskette each contain 
the data file for the program to which you have made changes. Once this 
service has been completed, you must also transfer the form update file 
(file type of .LOO) onto the production diskette using service option 6 
(TRANSFER PROGRAM FILES). 


This service requires two disk drives on the computer. 


In order to use this service you must first place the production diskette 
(object disk) on the program disk drive (usually drive B) and then select 
Service 5 (TRANSFER FORM CHANGES). During the process of transfer, 
you will be asked to place the development diskette on disk drive “A” (or 
another disk work drive) temporarily. 


This service will only transfer changes made on one form at a time. If you 
need to transfer changes made on other program units, then you must 
return to the PROGRAM DIRECTORY menu and select the other forms 
that need the transfer of FORM changes. 


TRANSFER PROGRAM FILES 


Function 6 will transfer program files from one disk to another. It is most 
helpful when setting up a production disk, or when a transfer of changes 
made on the development disk to the production disk is required. 


This service requires two disk drives on your computer. 


In order to use this service, you must first place the production diskette 
(object disk) on the program disk drive (or drive B), then select Service 6 
(TRANSFER PROGRAM FILES). During the process of transfer, you will be 
asked to place the development diskette on disk drive “A” (or another disk 
work drive) temporarily. 
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SUMMARY 


One of the most powerful features of PERSONAL PEARL is to allow you to 
extensively alter your input form after you have created a data file without 
having to re-enter the data on your file to use the new form. The following is 
a description of the alterations you can make. If your files have been 
placed in a Production configuration as described above, you will need the 
service the PEARLFM program in order to install the changes you have 
made. If your files are still ina development configuration (that is, all of the 
control files and data files are on the same diskette), you may or may not 
need the services of the PEARLFM program as described below. 


In all cases, if your data file is in production status (that is, the data files and 
the control files reside on separate disks), you will need to use option 5 on 
the File Maintenance Service menu in order to transfer the form changes to 
your data file. If you are still using a development configuration, option 4 will 
not be needed before the following file maintenance operations are 
performed. 


Alteration PEARLFM Services Provided 
Change an existing When a key is added, the index must be rebuilt 
input area to an using option 2. 
indexed area | 
Change an existing When a key field is deleted, the index must be 
indexed area to a “rebuilt”. 


nonindexed area 


Delete an input When an input area is deleted, option 3 may be 

area from the form used to copy and compress the data file. While 
this will remove the data for the delete input 
area _ from the file, it is not required. 


Add an input area No file maintenance is necessary. 
to the form. 
Add a reference No file maintenance is necessary. 


to another form. 


Extend the length of No file maintenance is necessary. 
the input area 


Decrease the length of No file maintenance is necessary. 
of an input area 
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Changing the position _No file maintenance is necessary. (Note: 

of existing input Always be sure to use the same input area 

areas on the form name. If you do not, it is the same as deleting 
one input area and adding another. 


The following alterations of existing forms are not allowed by PERSONAL 
PEARL. If you make these alterations, you will have to create a new data 
file from scratch. That is, these alterations may not be applied to existing 
data files. 


Alterations 
Change input area For example, you may not change the TYPE of 
TYPE an input area from a C)haracter to a Date, or 
vice versa. 
Change input area If you change the NAME of an input area, you will 
NAME effectively delete all of the data stored under the 


old name, and begin storing new data using the 
new name. 


Chapter 6 


CP/M File Maintenance 


CP/M file maintenance will allow you to move ahead with useful information 
already in your possession. File maintenance involves both knowledge of the 
operational rules of the CP/M operating system and knowledge of the 
importance of good file maintenance. 


Your PERSONAL PEARL software operates under the CP/M operating system 
provided with your computer. Maintaining and working with programs and data 
files under this, or any, operating system, requires knowledge of some of the 
system’s functional commands. The CP/M commands that are most important 
for you to know in order to operate your system are: the COPY, PIP, STATus, 
DIRectory and ERAse commands. Please review your manuals for the appro- 
priate CP/M operating commands for your system. Knowledge of these 
commands helps assure data integrity and facilitates data handling. 


We cannot stress enough the importance of good file maintenance. Proper file 
maintenance can mean the difference between finishing the job or starting over, 
moving ahead on a project or backtracking. There are few things more 
frustrating than having to redo hours of work because you somehow lost your 
files and aren't sure where you are. The following information provides you with 
some background knowledge of the above commands you need in order to feel 
confident when using PERSONAL PEARL. 


BACKUPS 


Backup copies of your disks can save you hours of re-entry time should a disk 
become inoperative. Duplicate copies give you security for your files and 
protect your investment of both time and resources. All backups must be done 
accurately and labeled (CAUTION: do not use ball point pens when labeling a 
backup disk; use felt tip). 


You should also make sure you have backups of your system disks so you Can 
continue processing should a system disk be destroyed. 


Backups should be done on a regular basis, scheduled either by disk or by file. 
For beginners, the disk method is easier although you should be familiar with 
both. When entering information into a program, you may wish to do a back-up 
every few hours. 
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In the event of a working disk failure, your backup will be used to create a new 
working disk by copying from the backup onto a fresh new disk. You should 
discard the disk that fails. 


FORMATTING DISKETTES 


You should format new diskettes before using them, and re-format diskettes 
which have been used on a periodic basis before backing them up. The CP/M 
COPY function allows you to format disks. 


Any time an error has been detected on a diskette, it should be reformatted 
before reusing. 


These simple procedures should provide you with good file maintenance habits. 
FULL-DISK COPIES: “COPY” 


When you choose to make a full diskette copy, all of the data on the diskette is 
copied on a track-by-track basis. (A track is very similar to a groove on a record 
platter.) Those tracks containing data are copied as well as those tracks which 
are empty. Variations of the command you enter is COPY “ALL”, “SYSTEM”, or 
“DATA”. 


BACKING UP FILES USING PIP (FILE-BY-FILE COPIES) 


The second alternative used to copy files from one diskette to another is PIP, 
the (Peripheral Interface Program). This program is used to make copies from 
one diskette to another on a file-by-file basis. 


When data is stored on a diskette, the data within a single file may be spread 
over a number of areas on a diskette. There will generally be a number of 
unused tracks on the diskette. PIP does not try to read any track on which there 
is no data stored. One variation of the PIP commanzd is: ‘PIP B:=A: fi Lename ”, 
instructing the computer to copy the file called “filename” from the disk on drive 
A to the disk on drive B. 


OBTAINING A DIRectory 


If you are Curious about the names you have given to your data or program files, 
in general, you use a CP/M command called a DiRectory which lists on your 
video screen the names of files and programs. 


All you need to do to get a list of your file names is to enter DIR after the A>. 
A>DIR or A>DIR B: 


Shows files on disk in Shows files on disk in 
drive A drive B 


CP/M File Maintenance oT 


Your video screen will display a list of file names, such as: 


A>DIR B: 

B: ADDRESS E00 sPEARL DIR ADDRESS ROO 
B: ADDRESS SOO sADRLIST EOO 

f> 


ERAsing FILES 


Another CP/M function that may at times be useful is the ERAse command. 
This command allows you to erase files from disk. You must be careful when 
using this function. In other words, make sure you want to erase a file from disk 
before using the command. The command works as follows: 


A>ERA.B:ADDRESS.EOO or jA>ERAPIP.COM 


Erases file ADDRESS.EOO Erases PIP.COM file 
from drive B from drive A. 


A>ERA B:*.BAK 


Entering this command would erase all files with a TYPE of BAK (your backup 
files on the disk currently in drive B). It would not erase any other files. 
Sometimes you may want to do this before you begin a disk-to-disk COPY 
DATA function in order not to copy over the back-up files, since copying the 
data onto another disk will serve as your backup anyway. 


CHECK STATus 


The STAT command may be used to check the amount of space left on the 
currently logged on disk in your computer. For example, for a two disk drive 
system: 


A>STAT or A>STAT B: 
Tells how much space Tells how much space 
is on disk drive A. is left on disk drive B. 


The command A>STAT."filename" lists the amount of disk space the 
“filename” takes up on the disk in drive A. 


The command A>STAT B:*.* lists the space left on the disk in drive B as well 
as listing all the files currently stored on that disk. 


Your CP/M manual will provide you with more in-depth discussions of the 
operating functions and variations of your CP/M system and the commands 
described above. 


Chapter 7 
Notes for BASIC Programmers 


The following is a discussion and an example of how data from PERSONAL 
PEARL data files may be processed by programs written in BASIC. You can 
access PERSONAL PEARL data files from your own BASIC program! 


In order to process PERSONAL PEARL data files from programs written in 
BASIC or any other programming language, an intermediate data file is created 
using the PERSONAL PEARL report writer. Special care must be taken in 
defining the output format of the file. The name of the output file created by the 
report writer must have the CP/M file type of .DAT. The following is a summary 
of the steps which are required, and a sample program written in MBASIC: 


1. Design a LIST-type report for the data file you are going to process. The 
report you create will be written to a data file which may then be read by a 
BASIC program. 


Note the following when you design the report: 


a. Any data you define in.the HEADING portion of the report will be 
Output only once at the beginning of the file you create. In most cases, 
you will probably not want to have any HEADING data at all. 


b. All output areas should be separated by commas. 


c. Character and date type output areas should have quotes around 
them. 


2. When you run the PEARLPR program to create the data file, the name of 
the output file must have a type of .DAT specified. This will tell PERSONAL 
PEARL that you do not want to skip to TOP of FORM between pages. 


3. Example: 


a. In the following example, the data file we are processing has four 
areas defined as follows: 


ONE Defined as a character area. 
TWO Defined as a numeric area. 


a FG's 
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THREE Defined as a data area. 
FOUR Acomputed numeric area. 
The following report has been defined: 


REPORT NAME: ARPT, PROGRAM NAME: BASICD 


DETAIL 

REPORT OUTPUT AREA ATTRIBUTES: 

1 DATA AREA NAME: ONE 
123456789 

2 DATA AREA NAME: TWO 
9999999999. 
1234567890 

3 DATA AREA NAME: THREE 
12345678 

4 DATA AREA NAME: FOUR 


29999999 99 
72345678901 
1 


When the report is run, the name of the output file is specified as: 
TEST.DAT 


The following MBASIC program can then be used to read and list the 
file: 


10 PRINT "READ DATA FILE CREATED BY PERSONAL PEARL REPORT WRITER" 
20 OPEN "'I"',1,"TEST.DAT" 

30 PRINT" ONE TwO THREE FOUR" 

40 MASK = "\ \ #HHH \ \ HHH HHH HH 

50 IF EOF(1) THEN 90 

60 INPUT#1 ,ONES, TWO, THREES, FOUR 

70 PRINT USING MASK$;ONES,TWO, THREES, FOUR 

80 GOTO 50 

90 PRINT "END OF INPUT FILE" 

100 STOP 


Chapter 8 


Security Features of PERSONAL PEARL 


INTRODUCTION 


PERSONAL PEARL provides several very important security and privacy 
features. These features help protect you from lost data, provide privacy of files, 
and provide a natural way of controlling program modifications. 


PERSONAL PEARL provides excellent data reliability and data integrity which 
protect you from hardware and operator errors. Further, should errors occur, 
PERSONAL PEARL will recover your data files with a minimum of trouble. 


PERSONAL PEARL has many features that are designed to solve any potential 
security and privacy problems in the office environment. These are discussed in 
more detail below: 


SECURITY 


hs 


Reliability and Data Integrity. 


Even the best computers are vulnerable to power failures and, to lesser 
extent, to static electricity, cosmic rays and other environmental factors. 
Crashed data files and “BDOS ERRORS” are a fact in computer opera- 
tions. PERSONAL PEARL provides complete file maintenance facilities for 
recovering data and index files which rebuild and verify most, if not all, of a 
crashed file. For example, suppose you have a power failure while updating 
your files. With many programs, this would render the data files useless. 
With PERSONAL PEARL, simply perform the index rebuild option of the file 
maintenance facilities, and your data file will be recovered. At the most, you 
will lose records being added when the power failure occurred. (See 
Chapter 5, section 2, for specific procedures.) 


Independence of Program Design and Program Operations. 


a. PERSONAL PEARL provides complete control of program modifi- 
cations. PERSONAL PEARL maintains independent design and opera- 
tions phases. When a program has been designed and goes into 
operation (or production), the operators need not have access to the 
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design process, and therefore, unwanted design modifications will be 
prevented. You simply keep your Design Forms (PEARLDF) and 
Design Reports (PEARLDR) disks in a physically secure location not 
available to the program operators, who only have need for Enter 
Data (PEARLED) or Produce Reports (PEARLPR). 


b. This feature also allows your system to be growing and changing 
while an earlier production program is “on-line” capturing and using 
information. When you have completed a new design, you can 
quickly replace the production copy that is used in the office, 
preserving the existing data files. The design process can continue 
and be repeated as often as necessary to keep your information 
system current with your growing needs. All the while, you maintiain 
physical control of the design disks. 


Modification of Sensitive Data Files. 


PERSONAL PEARL maintains security of data files in a fashion similar to 
that of a typical office. Office workers who do the paper filing have access 
to certain filing cabinets. Further, those in the office who create or process 
reports or other documents may not have access to all of the files. This 
usual office task organization is supported in PERSONAL PEARL by 
creating speciat purpose production program disks for the various people 
in the office. 


For example: When processing a payroll, one person may have a 
production program disk allowing for data entry of time tickets while 
another person has a production program disk which provides for printing 
checks only. Thus, you may give the responsibility for accurate data entry 
to one person and the responsibility for printing and mailing checks to 
another person who wont be able to change the amounts on the checks. 
In short, you can lock up your payroll production program disks the same 
way you now lock up your payroll filing cabinet. 


All that is required to insure security from unauthorized file modification is 
to control the use of PEARLED with a particular production program disk. 
Only the people responsible for updating the file should have access to the 
use of PEARLED and the production program disk. Locking up PEARLED 
whenever it's not being used by authorized personnel is like locking your 
files in the evening so the files cannot be modified. 
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PRIVACY 


uP 


Access to Sensitive Information. 


Ensuring privacy of sensitive information is accomplished by separating 
reporting from file updating. Let’s return to the example of payroll pro- 
cessing to illustrate limiting parts of the information on file from some users, 
while making it available to others. The person with the update disk 
(PEARLED) and payroll update program, the time card entry person, will 
have full access to the data files; however, the person with a reporting disk 
(PEARLPR) will have access to only the data specifically designated for the 
particular report. 


Thus, the privacy of information in the payroll file is controlled through 
limiting particular people to the use of PEARLPR and a specific program 
report. You can split up a series of different reports to reflect the specific 
authorized file access available to a series of people. Each person will only 
have access to the report(s) appropriate to their job function. 


The separation of reports into different physical disks is accomplished by 
copying the “master” program production disk onto a second disk, and 
then deleting reports that are unauthorized for the persons who will use the 
second disk. In order to set up a production program disk with one or more 
of the reports deleted from the disk, the following steps are required: 


a. Create a production program disk as described in Chapter 5, Section 
6. When this is done, your production program disk will contain a 
master copy of all reports you have designed. 


b. | Make a second copy of the master production disk. The copy is the 
disk you will set up with only certain authorized report programs on it. 


c. In order to set up a disk with only certain reports to be accessible, use 
the Design Reports (PEARLDR) program to delete the unauthorized 
reports from the disk. This can be done by placing the second copy of 
the production program disk in drive B when PEARLDF is run. After 
you have selected the Design Reports option, enter the name(s) of 
the report(s) you wish to delete from the Report Directory, then press 
ctrl/O rather than return. 


d. Finally, exit to CP/M and delete the report file from the second copy 
of the production program disk. For example, if the name of the report 
you wish to delete is CHECKS, then enter the command: ERA 
B: CHECKS .MOO. 
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Check the CP/M directory for the exact name of each report to be 
deleted. If you have any questions about using CP/M, see Chapter 6 
for general reference and your CP/M user’s guide for details. 


PRIVACY FROM FILE READING THROUGH OTHER OFFICE 
PROGRAMS 


Beyond the physical control of your production programs, the actual data files 
have another measure of privacy. PERSONAL PEARL stores data in a unique 
packed format which cannot be casually processed for reading by other 
computer programs, like BASIC programs, word processors, such as WordStar, 
or CP/M utilities. 


Appendix A 


Messages and Codes 


FORM AND REPORT INSTALLATION 


200 DATA TYPE CHANGED 


REASON: 


ACTION: 


This condition occurs after the initial installation of a form. The form 
has been edited, and the TYPE for an input area has been 
changed. For example, an input area named BRTHDAY was 
originally specified as being a Date field, then changed to Char- 


acter. 


Prior to reinstalling the form, you may make one of the following 
choices on how to proceed: 


ie 
oa 


You may change the input area back to the original TYPE. 


You may change the name of the input area. If you make this 
choice, however, you will lose any data which has been 
placed in your data file under the original name. 


You may delete your data file. If you make this choice, you 
will lose any data you have placed in your data file. In the 
case that you are still testing your form and have not any 
data but test data, this would probably be the best choice to 
make. 


In order to erase the data file, you must exit to CP/M and 
use the CPM ERAse command. 


For example: 


lf your form name is CUSTMR, then you should delete 
CUSTMR.DOO on the program disk. This may be done using 
the CP/M ERAse command, i.e., ERA B: CUSTMR.DOO. 


Or if you choose options 2 or 3, any reports you have defined may 
also have to be edited and/or reinstalled. 


3854 
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204 DATE AREA TOO SHORT 


REASON: 


ACTION: 


Data input area too short. 
For example: 


If you define a data input area as a date, the size of this input area 
must be at least eight characters to accommodate the format 
mm/dd/yy. 


Edit the form to increase the length of the input area, then reinstall 
the form. 


205 MAXIMUM INPUT AREA COUNT EXCEEDED 


REASON: 


ACTION: 


Over a period of time, the total number of input area names 
assigned has exceeded the maximum number of 250 for a single 
form. This includes those fields which have been assigned and 
then deleted or renamed. 


You have two choices. 


We Delete any new data fields added during the last update, 
then reinstall the form. This will allow you to use the original 
form on existing data files. 


2: Delete the data file for the form, then reinstall. In this case, 
you will not be able to use the form to process the data in 
any existing data files which have been created and updated 
using the form. The number of active data input areas will be 
reduced to the actual number currently defined on the input 
form. 


207 DATA TYPE MISMATCH 


REASON: 


ACTION: 


ie The same data input area name is used on two different 
forms; and 

2: In a report or a form definition, data is obtained from another 
form using option 4 on the design forms/design report 
menus and 


SF The TYPE of one data area does not match that of the other 
(i.e., if one was defined as “‘C” (character), and the other was 
defined as “N” (numeric)). 


Change the TYPE for the input area for one or the other of the 
forms or reports being installed, then reinstall. 
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208 INPUT AREA NAME NOT FOUND 


REASON: 


ACTION: 


Option 4 on the design forms or design reports menu has been 
used to join two data files or forms together, and the input area 
name cannot be located in the other form. 


F 


Verify that the name you are using to identify an input area 
on the other form is the same name used to identify the area 
on the other form. 


Verify that the other input form has been installed. (Even 
though the other form has been designed, the input areas do 
not become available to other forms or reports until the 
forms have been installed.) 


Change the area name if necessary, then reinstall the form 
or report. 


209 INPUT AREA IS NOT INDEXED 


REASON: 


ACTION: 


Option 4 in the design forms or design reports menu has been 
used to join a form or a report to another form, and the input or 
output area used to join the files together has not been defined as 
an indexed area on the other form. 


i 


Edit the other form and define the input area used to link the 
forms as an indexed area (option 3 on the design forms 
menu.) 


Reinstall the form. (If you have active data files for that form, 
you will also have to use the file maintenance program 
(PEARLFM) to rebuild the index for that file.) 


Reinstall the form or report in which this condition has 
occurred. 


210 TOO MANY FORMS REFERENCED 


REASON: A report or a form has been designed to reference more than four 
other forms. 


ACTION: 


Reduce the number of references to other forms to 4. 
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211 FORM NOT FOUND 


REASON: 


ACTION: 


During installation of a form or a report, PEARL was unable to find a 
FORM name specified using option 4 of the design menus to join 
forms together. (The detail information for the form is located on 
the .DOO file for the form which is created during installation.) 


A Verify that the correct name is specified in ooption 4 of the 
design menu. 


2: Verify that the other form has been installed. 


3, Reinstall the form that was being installed when this condi- 
tion occurred. If you have split files between several disk, be 
sure that the form.DOO file for the other form is on the 
development diskette during the installation processing. 


212 NO PATH TO OTHER FORM 


REASON: 


ACTION: 


No “path” index defined on a receiving form. 


This condition occurs when one or more path data areas were 
defined on a receiving form or a report and none were defined as a 
“path” index. A “path” index is required to select the correct record 
from a sending form data file. 


One “path” data area should have a “Y” response to the question 
DOES DATA IN THIS AREA IDENTIFY RECORDS FROM 
ANOTHER FORM (Y/N). See Optional Step 4, Chapter 8. Also, see 
CODE 209. 


Select the ‘‘path’” index used to join the forms together, and then 
reinstall the form or report. 


213 MULTIPLE PATHS TO ANOTHER FORM 


REASON: 


ACTION: 


Too many path indices defined on a receiving form. Requires that 
Only one data area be defined as indexed and receiving data from 
another form (path index). 


This condition will occur when you have defined more than one 
path index to a single external form. (See Optional Step 4, Chapter 
8.) 


Select the one input or output area used to link the forms together, 
then place an “N” in response to DOES DATA IN THIS AREA 
IDENTIFY RECORDS FROM ANOTHER FORM in all other data 
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areas to be provided by other forms, and then reinstall the form or 
report. 


214 DATA DICTIONARY ALLOCATION EXCEEDED 


REASON: There have been so many additions made to the form since it was 
originally installed that the area allocated to the data dictionary at 
the beginning of the data file has overflowed. 


This condition is likely to occur if a very small form has been 
defined and installed initially (Say one or two input areas), and then 
many large input areas are added to the form later. 


ACTION: — The data file containing the data dictionary will have to be deleted, 
and the form reinstalled. (Refer to condition code 200 for an 
example of how a data file may be deleted.) 


The best solution here is to prevent the situation from occurring by 
not installing a form with only one or two input areas defined when 
it is known that there will be a large number of input areas required. 
in the same form later on. 


215 DUPLICATE: OUTPUT AREA NAME 


REASON: In a report definition, two Computed output areas have been 
assigned the same area name. 


\ 
s 


ACTION: Change the name of one of the areas and reinstall the report. 
216 CIRCULAR REFERENCE 


REASON: One of the variables in a computation is derived from the input or 
Output area being computed. 


This condition will occur if, for example, you define areas A, B and 
C where A uses B in a computation; B uses C in a computation, 
and C uses A in a computation. This condition would not occur if C 
did not use A in the computation. 


ACTION: Restate the computations without circular references, then reinstall 
the form or report. 


217 AREA IS NOT NUMERIC 


REASON: A non-numeric input area name has been used in a computation. 
For example, an input area defined as a “C’haracter or a “D’ate 
has been used in the computation. 


90 PERSONAL PEARL Reference Manual 


ACTION: Restate the computation to use only numeric input area names. 
Then reinstall the form or report. 


218 AREA NAME NOT DEFINED 


REASON: An input or output area name used in a computation could not be 
located. 


ACTION: 1. 


If the area name refers to an input area in another form, 
make sure that a path to the other form is identified. Also, if 
the same area does not appear in the form or report being 
installed, make sure that the other program name is used as 
a prefix to the area name in the computation. (For example, 
in order to use an area name RATE which appears in the 
program PAYMSTR, specify PAYMSTR.RATE as the area 
name, not just RATE.) Also verify that the other form has 
been installed. 


If necessary, restate the computation so that only existing 
fields are used. Then reinstall the form or report. 


220 SORT KEY NOT DEFINED 


REASON: _ This condition occurs when an input area name specified as a sort 
sequence key (option 3, design reports menu) has not been 
defined on the input form. 


ACTION: — Edit the sort sequence keys to use input area names used in the 
data input form, then re-install the report. 


221 UNBALANCED PARENTHESIS 
Refer to 248 below. 


222 NAME LENGTH 


REASON: The maximum length of an input area or output are name used in a 
computation was exceeded. 


ACTION: | Edit the computation. (The full text of the computation will be 
displayed or listed with a 248 or 249 number by it.) Then reinstall 
the form or report. 
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223 SYNTAX 

Refer to code 248 below. 
224 INVALID CONSTANT 
Refer to 248 below. 

248 SYNTAX 


REASON: PEARL cannot determine how to compute an input area. This 
condition may occur for one of several reasons: 


1; Between two input area names, there must be one operator 
(operators are: *, ~, + or /). 


2: Between an input area name and a constant, there must be 
one operator. 


3; An input area name starts with a numeric character. 


4, The number of right-hand parenthesis does not match the 
number of left-hand parenthesis. 


ACTION: — Restate the computation and reinstall. 
249 SYNTAX 


REASON: Same as 248. However, in this case a pointer ““” indicates the 
point at which PEARL could no longer understand the expression. 


ACTION: — Edit the computation and reinstall. 


“r 


ts 


Appendix B 
Program Stop Codes 


The following is a summary of the messages and codes which are provided by 
PEARL when a condition arises making it impossible for PEARL to continue 
processing, along with a description of why the condition occurred, and what 
action should be taken. 


FILE NOT FOUND (280-289) 
280 PEARL.AOO not found 
The PEARL SYSTEM file (PEARL.AOO) is not on the PEARL SYSTEM disk. 


REASON: The PEARL SYSTEM file (PEARL.AOO) must be on every PEARL 
SYSTEM disk. The exception is when PSORT.COM and 
PEARLI.COM are on disks separate from the other PEARL pro- 
grams. 


ACTION: Place the PEARL SYSTEM file (PEARL.AOO) on the PEARL 
SYSTEM disk that was on the PEARL system disk drive at the time 
this error occurred. 


282 REPORT CONTROL NOT LOCATED 
REASON: | The report definition file (.ROO file type) could not be located. 


ACTION: Create the report definition file using option 2 (DESIGN REPORTS) 
of the SERVICE MENU to create a report. 


283 INPUT AND OUTPUT DRIVES ARE THE SAME 


REASON: The input and output drive to be used fora CREATE DATA FILE by 
the FILE MAINTENANCE PROGRAM were the same drive. 


ACTION: _ Edit the data file drive (3rd drive specified) and the copy file source 
drive (7th drive specified) in the INSTALL.DAT file DRIVES=option. 


The 3rd disk drive specified indicates the drive on which data files 
are stored, while the 7th drive specified indicates the source during 
the copy operation. If you have two drives on your system, you will 
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probably want to specify B as the data file drive, and A as the copy 
source drive. You must then run the INSTALL program to make 
these changes effective before using the option in the PEARLFM 
program to CREATE A DATA FILE. 


INCOMPATIBLE VERSION 
290 OBJECT MODULE VERSION ERROR 


291 


PEARL system version error. 


REASON: 


ACTION: 


An attempt was made to process a program or a data file which 
was Created with an earlier release of PEARL. 


All screens and reports should be reinstalled with your current 
copy of the PEARL system. 


294 PEARLxx.COM cannot be processed 


REASON: 


ACTION: 


During system installation one of the PEARL program files cannot 
be installed. This may be due to an unmatched set of the 
PEARL.AOO and PEARLxx.COM files, or the programs you have 
received may not be properly serialized. 


Contact the dealer or distributor from whom you purchased PEARL 
for assistance. 


295 PEARL.AOO file not located during system installation 


REASON: 


ACTION: 


The PEARL.AOO file could be located on the disk being processed 
during system installation. 


Be certain that there is a copy of the PEARL.AOO file on the 
DEFINE FORMS, DESIGN REPORTS, ENTER DATA, PRODUCE 
REPORTS, and FILE MAINTENANCE disks. If one of these disks 
does not contain the PEARL.AOO file, use PIP to copy the file. 
CAUTION: The PEARL.AOO file on the DESIGN FORMS disk 
should be used as the source file when making your copy on 
double density systems. This is the only PEARL.AOO file which 
is serialized by your distributor. You cannot INSTALL a 
system unless it has been serialized. 


297 WRONG USER ID 


REASON: 


Either the system has not been installed and a user id assigned, or 
the PEARL.AOO configuration file and PEARLxx.COM files are not 
of the same set. 


ww 
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ACTION: — Follow the system installation procedures to install your system 
and assign a user identification, if this has not been done, or verify 
that the PEARL.AOO and PEARLxx.COM files being used are a 
matching set. 


298 SYSTEM VERSION NUMBER ERROR 


REASON: The PEARL.AOO file which contains system configuration and 
control information, and the PEARL program files being used are 
not of the same version. 


ACTION: _ Verify that the files being used were distributed in the same set. 
299 SERIAL NUMBER VALIDATION 

Refer to 297. 

(300 - 307) I/O ERROR 


Invalid operation detected. Normally, these error conditions are associated with 
a disk directory being full, no room left on the data disk, a damaged disk, or a 
hardware failure in the disk drive or operation of the computer. 


301, 302 Invalid operation detected. 
REASON: | 1. Hardware problems, or 
a. Program failure. 


ACTION: 1. Make a fresh copy of the disks that were being processed 
from backup disks. 


ag lf Action 1 does not work, then contact customer support for 
help. 


303 Incomplete processing of program files. 
REASON: | 1. Hardware problems, or 
yas Program failure. 


ACTION: | 1. Use the PEARL system file maintenance program 
(PEARLFM, see Chapter 9 and Appendix D), to restore the 
program data files. This program is called PEARLFM.COM. 
Also verify any file maintenance statistics. 


2. lf Action 1 does not work, contact customer support. 
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304 - 306 Disk is full. 


REASON: Your computer operating system (CP/M) cannot increase the size 
or number of files on the disk. 


ACTION: 1. If you are sorting a report, then delete (see CP/M ERAse 
command, Chapter 3) any unnecessary files from your sort 


work disk. 

2; If you are creating a program, then remove unnecessary 
program files that are not associated with the one you are 
creating. 

3. If you are processing the program data files, and the 


program disk contains data for only one program defined by 
PEARL, then a new file will have to be started on another 
disk. Otherwise, delete unnecessary files on the data disk 
and use the file maintenance program (PEARLFM) to rebuild 
the index. 


309 FILE CLOSE FAILED 

REASON: An attempt to close a file has failed. 

ACTION: — Refer to 301, 302. 

307,319 Unrecognized return code from CP/M. Refer to 301, 302. 


(320 - 349) LOST DATA INTEGRITY 


REASON: An attempt to process a program has failed. This may be due to 
hardware or memory failure, or a program error. 


ACTION: — Follow steps in ERROR 301. 


(350 - 369) FILE MAINTENANCE REQUIRED 


PEARL provides you the capability to add or delete index keys, to add and 
delete data items in your data form file, and to redefine relationships between 
forms without re-entering the data on your files. In order to provide for this, 
however, the service of the PEARL file maintenance program (PEARLFM) are 
required. 
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If a file maintenance operation is required, one of the programs may stop with 
the message that file maintenance is required along with one of the following 


Codes. 


350 INDEX NOT COMPATIBLE 


REASON: 


ACTION: 


ce The data tiles were created and updated using an earlier 
version of PEARL, or 


2, The input form has been edited and new index areas have 


been defined, or previously defined index areas have been 
deleted. 


Use option 2 on the FILE MAINTENANCE menu to REBUILD THE 
INDEX for the data file or files which are being processed. 


351 DATA DICTIONARY/DATA FILE MISMATCH 


REASON: 


ACTION: 


A separate disk has been set up for data files and for program files 
using one or more of the file maintenance options 4, 5 and 6. At 
some point after this was done, the data file (and therefore the data 
dictionary) on the development disk was deleted and the form 
re-installed. The data file/data dictionary on the development disk 
is not compatible with the data file/data dictionary on the produc- 
tion disk(s). 


Each time a form is installed for the first time, a new data file (file 
type .D00) is created and a unique file identification code is 
assigned. This unique identification will never change regardless of 
the changes to the form. That is, new input areas may be added or 
deleted. However, if the data file is deleted and the form re- 
installed, then a new identification code is assigned, and any data 
files created on other than the original development disk may no 
longer be used. 


1: If it is necessary to maintain compatibility between existing 
data files and forms and reports which have been updated, 
copy the data dictionary (.D00 file) from the production data 
disk back to the development disk. Then, re-install all of the 
forms and the reports associated with the form. 


ea Create a new set of production disk using options 4, 5, 
and/or 6 in the file maintenance program. 


98 


PERSONAL PEARL Reference Manual 


352 DATA DICTIONARY NOT COMPATIBLE 


REASON: 


ACTION: 


The data files are not compatible with the update form being used 
for update. There are two situations which can cause this condition 
to occur. 


i 


I, 


If the data file and the program control files all reside on the 
same disk, this situation will occur if a request to install a 
form did not complete properly. In this case a message 
would have occurred on the screen during the install 
indicating that a computation did not compile properly, that a 
reference to another form could not be satisfied, etc. In this 
case the data file has been updated and the version 
incremented, but the update screen has not been fully 
installed. 


Production program and data files have been configured on 
separate disks. In this case the PEARLFM program may 
have been used to copy program or data files from the 
development to the production disk, but all of the necessary 
files were not copied. (For example, option 5 was used to 
transfer form changes to the data files, but option 6 was not 
used to transfer the program files.) 


Note the name of the data file being processed at the time 
the incompatiblity was detected. (This will be the name of 
the form you were using to update a file or produce a report 
unless your program uses multiple forms. In the latter case, 
the name of one of the external forms may appear in the 
message window.) 


If the name of the form being processed was an external 
form, to be safe you should re-install the external form, then 
reinstall the form for the form which was being used for 
update at the time you received the 251 code. Be sure that 
each form installation step is completed without any mes- 
sages before going to the next form. 


If you are using a development configuration where all 
program and data files are placed on a single disk, the 
process should be complete, at this point, and you should be 
able to perform the update you were attempting to begin 
with. 
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4. If you have configured your program files so that the data 


files and the program files do not reside on a development 
disk, the next step will be to use the PEARLFM program to 
transfer program changes (menu option 5) and program files 
(menu option 6) to production disks. This should be done for 
all program files which reside on a set of production program 
disks. That is, all referenced files as well as those files which 
do the referencing. 


Note that you may use option 1 on the PEARLFM menu to 
display the version number of each data file or form. The 
version number displayed on the production file disk should 
be the same version number displayed on the development 
disk for the same form when you have completed the 
transfer of files from the development to production disks. 


353 DATA/INDEX FILE NOT LOCATED 


REASON: 


ACTION: 


An attempt was made to process a form, or an external form during 
update or report processing. However, the, form could not be 
located on the data disk. The name of the form which could not be 
located is displayed in the message window at the time the 
message is provided. 


This will normally happen when development and production files 
reside on separate disks, and in setting up the production disks not 
all of the required files were transferred to the production disks. 


It may also occur, however, if there is a premature termination of a 
program in an installation step. For example, if a form is being 
installed for the first time, and you run out of directory space or your 
development disk is full, the data file (program.D00) may be 
allocated on the development disk, but the index file (form.E00) 
may not be allocated. 


1; Note the name of the form that was being processed at the 
time the incompatibility was detected. (The name of the form 
will be displayed in the message window and the bottom of 
the screen.) 


ia If you are working with a development disk configuration 
where all program files reside on a single disk, verity that 
both the data component and the index component of your 
program files reside on the disk. (Use the CP/M DIR 
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command to do this.) If the index file is missing, (form.E00), 
but the data file is there (form.D00) then you may use the 
PEARLFM program, menu option 2 to create a new index 
file. Before doing this verify that there is sufficient space on 
the disk. (You may do this using the CP/M STAT commana, 
or option 1 of the PEARLFM service menu.) 


Gf If your development and production files have been 
configured on separate disks, and you have forgotten to 
transfer all of the required files to the production disk, use 
menu options 5 and 6 to complete the transfer. 


354 PREVIOUS UPDATE NOT COMPLETE 


REASON: 


ACTION: 


The last time you updated your data file, the update Progen was 
not terminated normally. 


Use option 2 of the PEARLFM program to rebuild the index to your 
data file. (A standard part of this function is to verify the data which 
was being entered during the previous update.) 


357 ATTEMPT TO READ BEYOND END OF FILE 


REASON: 


ACTION: 


An attempt was made by the update or report routines to read data 
beyond what had been written to the file based on internal control 
pointers. This is most likely due to an update which did not 
complete properly. 


Use option 2 of the PEARLFM program to rebuild the index to your 
data file. (A standard part of this function is to verify that the data 
was being entered during the previous update.) 


358 DATA DICTIONARY WILL NOT FIT ON FILE 


Refer to installation condition 214. 


359 DATA FILE MISMATCH 


REASON: 


An attempt has been made to transfer form changes from the 
development disk to a production data file disk, and the data files 
do not match. This occurs if the data file on the development disk 
has been deleted and the update form reinstalled. 


This mismatch situation occurs when the unique file id on the 
development disk file is not the same as the unique file id on the 
production data disk. (You may use the file summary statistics 
display option to display the unique file id for each data file.) 


ACTION: 
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This check guarantees that there will always be a one to one 
correspondence between the input data areas in your input form 
and the data stored on your data file. 


You have probably made changes to your input form which you 
wish to incorporate into an existing data file. You may still do this by 
following the steps outlined below. Before you do this, however, be 
sure that you make a backup copy of both your production and 
development disks. 


1. Use option 4 of the PEARLFM menu to create a data file. 
However, reverse the direction of the copy, using your 
production data disk as the source rather than your devel- 
opment disk, and make the copy of the file to the 
development disk rather than to the production data disk. 
Note that this will effectively delete any data you have 
placed in the data file on your development disk. 


2. Reinstall the form for the program using the PEARLDF 
program. 


3. Use options 5 (transfer form changes) and 6 (copy program 
files) to transfer the changes from the development disks to 
your production disks. 


370 - 384 MEMORY POOL EXHAUSTED 


REASON: 


ACTION: 


You have defined a program that is too large or complex for your 
computer to handle. 


Reduce the size of the form or report you are trying to process. If 
the form you are processing calls other forms for information, then 
decrease the number of forms that are accessed. 


385 INSUFFICIENT MEMORY FOR MULTI-PRINT FORM BUFFERING 


REASON: 


ACTION: 


Insufficient memory available for report. The number and/or size of 
report forms that are to be printed side-by-side from left to right on 
a report page is too large (i.e., labels). 


1 Reduce the size of the form to be printed. 


fa Reduce the number of forms to appear from left to right on 
the report page. 
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386 INSUFFICIENT MEMORY AVAILABLE TO OPEN FILE 


Refer to 370 - 384. 


PROGRAM LOGIC ERROR (nnnn) 


REASON: 


ACTION: 


PEARL has detected a condition which makes it impossible to 
continue processing and still meet your expectations of high data 
integrity. 


Make certain that your computer is functioning properly, and that 
you have a good copy of the PEARL system programs. If the 
condition still occurs, contact customer support. 


In the following cases, you may take action to correct a situation 
caused by a PROGRAM LOGIC ERROR message. 


450 INCOMPATIBLE UPDATE MODULE 


REASON: 


ACTION: 


A request has been made to enter selection data in the Produce 
Reports program. However, the update control and the report 
control use a different version of the data dictionary. 


Use the PEARLDR program to reinstall the REPORT. 


1073 INDEX FILE IS NOT COMPATIBLE 


REASON: 


ACTION: 


This situation may occur when you are using the production 
release of PERSONAL PEARL to process a file created with a 
pre-release version of the system. 


Reinstall the form used to update the file with the PEARLDF 
program. Then use the PEARLFM, menu option 2 to rebuild the 
index for an existing data file. 


Appendix C 
PERSONAL PEARL Installation Controls 


When you enter the PEARLUP command, the INSTALL.DAT file is processed. 
The information in this file.is then available to PERSONAL PEARL during 
subsequent processing. 


If you wish to change some of the controls, you may use a standard word 
processor to edit the INSTALL.DAT file. You must then run the PEARLUP 
program again to make these controls effective. If you use WORDSTAR to do 
the editing, be sure to edit using the using the Non-document option rather than 
the Document editing option. Changing controls involves technical descriptions 
and concepts described below. Much of this material sounds very technical. If 
you need to get into this area, you may wish to consult your dealer or distributor 
for help. 


DISKS=abcdefg 


This option specifies which CP/M disk drives will be used for PERSONAL 
PEARL and your program files. 


a Drive for the system directory (PEARL.DIR). This file contains the directory of 
all forms defined. 


b Program control data drive is where the program definition files reside (files 
with the suffix of .L00, M00, .DIR, .SOO, and .ROO). 


c Program data file drive is the drive on which data files will be placed (files 
with the suffix of .DDOO and .E00Q). 


d Work drive. This drive is used for temporary work files from time to time. If 
work file space is required, and there is not enough space on this drive for 
the work files, you will be instructed to remove the disk currently on the drive 
and replace it temporarily with a blank diskette. This drive must not be the 
same drive as the program data file drive (c above) or PEARL will not 
execute properly. 


e This is the drive on which the help text (PRLHELP.TXT) file resides. If this file 
is not available during processing, no help text will be available. 


=406- 
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f System drive. This is the logged on CP/M drive during execution. All 
PEARLxx programs must reside on this drive. 


g Copy source drive. This drive is used by PEARLFM during some file 
maintenance operations. It may be the same as the system drive, but cannot 
be the same as the program data file drive. 


TERMINAL=n11 ,n2,n3,n4,n5,n6,n7,n8,n9,n10,n11,n12,n1 3,n14,n15,n16 


These values describe the layout of your screen. Except for the parameters 
described below, these values should not be altered as they are adjusted to fit 
the screen for your computer. 


ni The number of lines on the terminal. 


n2 The number of columns on the terminal available for defining forms 
and reports. The maximum value which may be used is 127. 


CURSOR=112233445566778899aabbccddee 


This parameter list specifies cursor positioning control codes. Any changes that - 
are made here will not be reflected in the control menus on PERSONAL PEARL. 
The control codes consist of 11 hexadecimal digits. Each digit consists of two 
characters. No spaces appear in the parameter list. 


11 Cursor forward 04-Control D 
22 Cursor backward 13-Control S 
33 Word forward 06-Control F 
44 Word backward 01-Control A 
20 Delete backward 7F-RUB or DEL 
66 Delete character 07-Control G 
xs Delete to end of word 14-Control T 
88 Not used EE-Unused 
99 Delete line/field 19-Control Y 
aa Insert on/off 16-Control V 
bb Alternate cursor forward OC-Control L 


CC Alternate cursor back 08-Control H 
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dd Alternate Cursor up OB-Control E 
ee Alternate cursor down OA-Control J 


DEF INE=112233445566778899aabbc cddee f fgghhi ij jkk 


This parameter list specifies control codes used during the definition of a 
program entry form or a report. Changes to these codes will not be reflected in 
the PERSONAL PEARL control key menus. 


11 

22 
33 
44 
oho) 
66 
rag 
88 
99 
aa 
bb 


CC 


Tab forward 


Tab backward 


Must be same as cursor back 


line up 

line down 
Scroll up 
Scroll down 
Return 
Escape 
Help 

Line insert 
Not used 
Add field 
Abandon edit 


Page forward 


Page backward 


Print screen 


Roll current line to top 


of screen 
Not used 


Not used 


09-Control | 
1E-Control “ 
13-Control S 
05-Control E 
18-Control X 
1A-Control Z 
17-Control W 
OD-Control M or RETURN 
1B-ESCAPE 
11-Control Q 
OE-Control N 
EE-Unused 
02-Control B 
OF-Control O 
03-Control C 
12-Control R 
10-Control P 
15-Control U 


EE-Unused 
EE-Unused 
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UPDATE=112233445566778899aabbccddeef fgghhii jjkkLlL 


This parameter list specifies keyboard control codes used during data entry a, 
processing. Changes to these codes will not be reflected in the control key 
menus. 


11. Tab forward 09-Control | 
22 Tab backward 1E-Control “ 
33 Same as cursor back 13-Control-S 
44 Line up 05-Control E 
95 — Line down 18-Control X 
66 HELP 11-Control Q 
77 Not used EE-Unused 
88 Return OD-Control M or RETURN 
99 Page forward 03-Control C 
aa Page back 12-Control R 
bb Toggle ADD/EDIT 02-Control B 
cc ~—Not used EE-Unused 
dd_—~Print 10-Control P 
ee Delete record OF-Control O 
ff Unused EE-unused 
gg  Add/replace 15-Control U 
hh Get next record 1A-Control Z 
i Get previous record 17-Control W 
jj Duplicate field from OE-Control N 
previous record 
kk Not used EE-Unused 
I Escape 1B-ESCAPE 
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PRINTER=n1 ,n2,n3 


Defines the printer which is being used on the system. This parameter list 
specifies printer/report characteristics. The list consists of 3 parameters and 
starts after the word “PRINTER=". Each parameter is followed by a comma “,’, 
and is an integer number. No spaces may appear in this parameter list. 


ni Is the width of the printed page in columns. 


n2 Is the number of lines per page, or zero if the printer is equipped with form 
feed control (CHAR (12)). 


n3.__—Is the number of data output lines to print before skipping to top of the 
next page. 


DATE=n 

O Use the mmddyy format for dates. 
1 Use the ddmmyy format for dates. 
GDIAG=o 


Specifies where the program installation diagnostics messages will be output. 


GDIAG=C Console. 
GDIAG=P System printer. 
CHARR=L Lhh 


This parameter list specifies the range of characters that may be entered by the 
operator in defining report, entry forms, and entering data into the completed 
program. This set of characters does not include other sets involved with 
“control keys”. The parameter list consists of two hexadecimal digits (each two 
characters). The first is the low character, the second is the high character. The 
list follows “CHARR=". 


I Is the low character value. Default = 20", space. 
hh — Is the high character value. Default = “7E", a tilte. 
SCREENS= 


This parameter indicates that a list of terminal attributes is to follow. The 
SCREENS= section must appear at the end of the INSTALL definition file. Each 
terminal defined in this section will appear on the selection menu during 
PEARLUP processing. If the definition for only one terminal appears, that 
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Appendix D 


Setting Up Production Program Disk 


During the design and development phase, it is convenient to keep all of the 
PERSONAL PEARL definition and development data files on a single work or 
development diskette. This enables you to make a change to a form or report, 
use the reinstall function, and then to test the changes with a minimum amount 
of swapping diskettes. However, once you are ready to enter data into your data 
files on a production basis, it is advisable to set up a production configuration for 
your program diskettes. There are three reasons for this: 


he 


To allow you to make changes to forms and reports in the future without 
impacting your production data files. These changes can be made using 
the development files independent of your production files, and then if the 
changes are satisfactory, they can be transferred to your production files. 


To maintain several data files on separate diskettes, each of which uses 
the same input form for data entry. 


To get the maximum number of data records on a file. Several of the files 
created during the design of forms and reports do not need to be available 
when the Enter Data and/or the Produce Reports programs are used. By 
setting your diskettes up in a production configuration you can use all of 
the space on the diskette for data files. 


This appendix describes some of the details pertinent to a production configura- 
tion. The actual steps required for the configuration of a production disks are 
described in the chapter on use of the File Maintenance services, and in the 
advanced tutorial. 


The topics discussed are as follows: 


As 


2 
3 
- 
2) 


A summary of the files created and processed by PERSONAL PEARL. 
The concept of DEVELOPMENT and PRODUCTION DISKETTES. 
Required program file configuration. 

How to reset the computer disk drive setup for program files. 


Sample program diskette configurations. 


11s 
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You may also need to refer to Appendix C which describes the manner in which 
disk drives are allocated by PERSONAL PEARL. 


1. FILE TYPES USED BY PERSONAL PEARL. 


The function and content of the disk files created by PERSONAL PEARL 
are described below. (The “*” signifies that the file is required to operate 
the program units in its final production phase. When the words “form” or 
“report” appear as part of the file name, they represent the actual form or 
report name entered by the user of PERSONAL PEARL.) 


File name 


PEARL.DIR * 


form.SOO 


form.DO0O * 


form.E00O * 


form.DIR * 


report.ROO 
form.LOO * 


report.M0O * 


form.Q00 
form.KOO 
form.T00 
form.V0O 
form.P00 
form.FO0O 


Description 


This file is created by PERSONAL PEARL and 
contains the directory of all the program units or 
form names that you have defined. 


This file contains all the information that you have 
made in designing your entry form. 


This file contains all the data that you will enter 
when you use the entry form. This is also referred 
to as the data file. 


This file is the data index. It also contains data that 
you enter using your entry form also known as the 
data file index. 


This is the program unit report directory. It contains 
the names and descriptions of all the reports that 
you have defined fer a given program unit or form. 


This file contains your definitions for a report. 


This file is required in order to enter data into your 
entry form. 


This file is required in order to print a report that 
you have defined. 


These files are temporary files used by 
PERSONAL PEARL from time to time, and are 
normally deleted from the diskette after they have 
served their purpose. If they appear on your direc- 
tory, you may delete them at any time without loss 
of any of the data you have entered. 
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THE CONCEPT OF DEVELOPMENT AND PRODUCTION DISKS. 


Although PERSONAL PEARL allows the creation of programs that are 
ready to operate in a matter of a few minutes, most created programs will 
require some form of testing and revision. This is especially true when 
more than one person will use the created program. 


To facilitate the revision of a program without halting its use by others, the 
created program should be set up on two types of diskettes: 


a. The DEVELOPMENT DISKETTE: This disk is the program diskette on 
which testing and revision of the created program is to occur. 


b. The PRODUCTION DISKETTE: This diskette to be used as the 
production copy of the program. 


To transfer the revisions made on the DEVELOPMENT DISKETTE onto the 
PRODUCTION DISKETTE requires the use of the PERSONAL PEARL file 
maintenance service (PEARLFM). 


To initially set up a PRODUCTION DISKETTE, you should first format a 
new diskette. You may then either copy the DEVELOPMENT DISKETTE 
onto the PRODUCTION DISKETTE or use the “TRANSFER PROGRAM 
FILES” service option on the FILE MAINTENANCE menu. 


REQUIRED PROGRAM FILE CONFIGURATION. 


This section will set forth the mandatory configuration of program unit files 
in order to operate the programs you created. The term “configuration” is 
used to describe the groups of files that must be on the same diskette, and 
those that can be on a separate diskette. You will be able to rearrange the 
program files in any way you choose without affecting their operation as 
long as you follow the configuration rules set forth below. 


Any given program unit you develop will result in the creation of three to 
more than eight files on the program diskette. There is a maximum of three 
separate diskettes on which any one set of program unit files can be 
grouped. Given that your program unit form name is “formx” these groups 
are: 
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DEVELOPMENT DISKETTE configuration. 


Group Files 
a PEARL.DIR 
b formx.S00 


formx.DIR 
report.ROO 
formx.L00 
report.MO0O0 


C formx.D00 
formx.E00 


This is the program directory. 
This is the FORM definition file. 


This is the program unit report directory. 
This is the report definition file. 

This is the form update file. 

This is the report production file. 


This is the form data file. 
This is the index file. 


PRODUCTION DISKETTE configuration. 


Group Files 
a PEARL.DIR 
b formx.DIR 
formx.L0O0 
report.MOO 
fe: formx.D00 
formx.E00 


This is the program directory. 


This is the program unit report directory. 


This is the form update file. 


This is the report production file. 


This is the form data file. 
This is the index file. 


NOTE 


If groups “a” and “b” reside on the same disk drive, then they must reside on the 


same diskette. 


You may also delete “formx.L00” from group “b” ona production disk if only reports 


are to be produced on the data file. 


If you have developed a program that consists of more than one form or 
program unit, then you should combine all similar files together. In other 
words, you should combine all the program data and program index files 
on the same disk, and all the program report directories, data update files, 
and report production files together on the same disk. 
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For example: 


lf you designed a program unit that consists of a form called MASTER, and 
another called ADDRESS where both are required to be processed at the 
same time, then the development diskette should have the following 
configuration: 


Group Files 
a PEARL.DIR 
b MASTER.DIR 
ADDRESS.DIR 
MASTER.LOO 
ADDRESS.LOO 


REPORT1.ROO ~=‘This is a MASTER program unit report. 

REPORT2.R00 ‘This is another MASTER program unit 
report. 

REPORT3.ROO This is an ADDRESS program unit report. 

REPORT1.MO00 

REPORT2.M00 

REPORT3.MO00. 


Cc MASTER.DOO 
MASTER.E00 
ADDRESS.D00 
ADDRESS.E00 


HOW TO RESET THE COMPUTER DISK DRIVE SET UP FOR 
PROGRAM FILES. 


PERSONAL PEARL is initially setup to operate on two computer disk 
drives. Since your operating system is CP/M, then these two disk drives 
are “A”, and “B”, respectively. This is called the initial disk drive configura- 
tion where the PERSONAL PEARL disk drive is “A”, and the program disk 
drive is “B”. 


This configuration requires that there be only one program diskette for a 
given program or set of programs. This set up is ideal for development 
because it minimizes development time. However, this setup may not be 
ideal for production purposes. The overriding limiting factor on a computer 
is the capacity or storage space available on a diskette during production 
processing. 
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The opposite may be true for a computer with a hard disk. In this case, only 
one disk drive may be necessary for development and production 
purposes. 


PERSONAL PEARL provides the operator with an option to reconfigure the 
program diskettes on the available computer disk drives to satisfy the 
particular needs of the computer or the program that is developed (see 
Appendix C on PERSONAL PEARL INSTALLATION CONTROL DATA). 


PERSONAL PEARL provides for a maximum of three computer disk drives 
for the placement or configuration of the program files. In order to change 
the disk drive designations from those that were present when you 
purchased the PERSONAL PEARL package, you must edit the 
“DISKS=abcdefg” section of the INSTALL.DAT file first and then PEARLUP 
PERSONAL PEARL, again. 


SAMPLE PROGRAM DISKETTE CONFIGURATIONS. 


This section will illustrate four program diskette configurations. These 
configurations are not mandatory but are suggested. These configurations 
will work for development and production program disks. The 
configurations discussed will also have computer disk drive and program 
diskette designations. 


References to “Program disk #1" and “Program disk #2”, correspond to the 
PROGRAM SUPPORT DISKETTE and the PROGRAM DATA DISKETTE, 
respectively. 


a. PERSONAL PEARL standard program file configuration. 
This configuration consists of one diskette for the program files. 


The installation control file (INSTALL.DAT) has a disk designation as 
follows: 


DISKS=BBBAAAA 


Computer 

Disk Diskette 

Drive Name File Description 
B Program disk PEARL.DIR program directory 
B Program disk form.SO0 FORM definition file 
B Program disk form.DIR form report directory 
B Program disk report.ROO report definition file 
B Program disk form.LO0 form update file 
B Program disk report.MOO report production file 
B Program disk form.DO0 form data file 
B Program disk form.E00 index file 
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PERSONAL PEARL standard program file configuration with two 
program diskettes. 


The installation control file (INSTALL.DAT) has a disk designation as 
follows: 


DISKS=BBBAAAA 


Computer 

Disk Diskette 

Drive Name File Description 
B Program disk #1 PEARL.DIR program directory 
B Program disk #1 form.SOO - FORM definition file 
B Program disk #1 form.DIR form report directory 
B Program disk #1 report.ROO report definition file 
B Program disk #1 form.LOO form update file 
B Program disk #1 report.MOO report production file 
B Program disk #2 form.DOO form data file 
B Program disk #2 form.E00 index file 


Program file configuration with two program diskettes on two com- 
puter disk drives. 


The installation control file (INSTALL.DAT) has a disk designation as 
follows: 


DISKS=AABAAAA 


Note that the Program disk #1 is the same as the PERSONAL PEARL 
system diskette. This is possible if you have enough room on the system 
disk. This configuration is most practical when the program is in production 
mode where only the ENTER DATA and PRODUCE REPORTS functions 
of PERSONAL PEARL are needed on the system diskette. This 
configuration is not suitable for single-density systems. 


Computer 
Disk Diskette 
Drive Name File Description 
Program disk #1 PEARL.DIR program directory 

A Program disk #1 form.SO0 FORM definition file 
A Program disk #1 form.DIR form report directory 
A Program disk #1 report.ROO report definition file 
A Program disk #1 form.LOO form update file 
A Program disk #1 report.M0O report production file 
B Program disk #2 form.D00 form data file 
B Program disk #2 form.E00 index file 


118 


PERSONAL PEARL Reference Manual 


Program file configuration with three program diskettes on three 
computer disk drives. 


The installation control file (INSTALL.DAT) has a disk.designation as 


follows: 


DISKS=AGBAAAA 


Computer 
Disk 
Drive 


A 


WDWQMDOADADDD 


Diskette 
Name 


Directory disk 


Program disk #1 
Program disk #1 
Program disk #1 
Program disk #1 
Program disk #1 
Program disk #2 
Program disk #2 


File 
PEARL.DIR 


form.S00 
form.DIR 
report.ROO 
form.LOO 
report.MOO 
form.D00 
form.E00 


Description 
program directory 


FORM definition file 
form report directory 
report definition file 
form update file 
report production file 
form data file 

index file 


Appendix E 
General File Maintenance Procedures 


File Maintenance, as the term “maintenance” implies, involves operations that 
are performed periodically on your data files. They are necessary in order to 
obtain maximum performance from the combined use of your computer, 
PERSONAL PEARL and your personal data files. 


File maintenance is provided in part through the use of CP/M utilities and in part 
through the use of the PERSONAL PEARL file maintenance (PEARLFM) 
program. Discussion of some CP/M commands may be found in Chapter 6, 
and Chapter 5 contains procedures for initiating file maintenance. 


This discussion of file maintenance is divided into four sections: 
1. Asummary of the file maintenance functions, and why you need them. 
2. Adescription of the PERSONAL PEARL file organization. 


3. Adescription of how PERSONAL PEARL data files can be configured on 
your system to maximize disk storage utilization for your computer. 


4. A detailed description of how to use each function provided by the 
PEARLFM program. 


If you are just beginning to to use PERSONAL PEARL, you will probably want to 
scan the first section, and bypass the other sections for now. Once you become 
familiar with the use of the system, you may need to return to the detailed 
description of each function its usefulness for your situation becomes evident. 


1. FILE MAINTENANCE, SUMMARY DESCRIPTION 
The operations covered in this section are: 


a. Configuring your data files to beable to store the maximum amount of 
data on a single diskette. During development of a program, there are 
a number of files which are necessary to Design Forms and to Design 
Reports, but which are not required in order to Enter Data and to 
Produce Reports. 


£449: 
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The steps required to change the design of your form or reports after 
you have entered some data on your data file. For example, in your 
Original form you did not include the Phone Number. After you created 
your data file, and filled out a number of forms, you realized that you 
really need to have the phone number on your form. There are 
several steps required in order to change and install a new form and 
to use the data from the forms you have already filled out. 


Making backup copies of your data files. 


Making multiple data files using the same input form. For example, if 
you want to create more than one file of names and addresses using 
the same input form. 


Recovering and verifying the integrity of your data after a system 
failure has occurred. This may be necessary, for example, if the 
power to your computer is lost during the Enter Data operation, and 
your data files were not closed properly. (During the close operation, 
information which is in the memory of your computer is written to 
diskette to complete a permanent record.) 


Copying a data file to compact the data. When you delete or edit 
forms on your data file, some space may be left unused on your data 
file diskette. The copy function provided by the PEARLFM program 
will compact your data file by only copying the data which Is active on 
your file. 


PEARL FILE ORGANIZATION 


a 


Disk Drive Names. 


The disk drive on which a file will be expected to be found or will be 
placed is specified in the INSTALL.DAT file by the DISKS=abcdefg 
specification. The following is a description of the values provided as 
defaults in the distribution system. (Also see Appendix C for additional 
description of the DISKS= and how to alter the disk drive specifi- 
cations on your system.) 


a(B) System Directory 
The PEARL.DIR is placed on this drive. 
b(B) | Form and report control 


The form.S00, form.LOO, report.ROO and report.MO0 files are 
placed on this drive. Also, miscellaneous temporary work 
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files are placed on this drive during INSTALL forms and 
reports processing. 


Data file drive. 
The form.D00 and form.E00 files are placed on this drive. 
System drive 


This is the drive containing the PEARLxx program files. This 
must always be the logged in drive. The PEARL.AOO system 
configuration data file must also be located on this drive. 


Sort Work drive. 


This is the drive containing the PSORT program and which 
is used for sort work files during sorts. 


The HELP text drive. 


This is the drive on which the PEARLxx programs will look 
for the PRLHELP.TXT file. 


COPY SOURCE 


This is the drive on which the source data file will be placed 
during the file compress and copy operations performed by 
the PEARLFM program. 


The following is a discussion of the files created by PERSONAL PEARL 
during the Design Forms, Design Reports, and Enter Data operations. In 
the following discussion, a basic understanding of the naming conventions 
used by CP/M is assumed. 


D: 


PERSONAL PEARL Directory. 


The PEARL.DIR file contains the directory of all of the forms you 
have defined. This file is expected to be on the system control file 
diskette by all PEARL programs. 


Design Forms. 


When you design a form, a Source Form file is created. The name of 
the file is formx.SOO where formx is the name of the form you have 
created. This file is required only when you change the design of the 
original form, and when you select the option to INSTALL a FORM. 
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During the INSTALL FORM process, three additional files are created. 


form.LO0 (Update control file.) 
form.DOO (Form Data file and data dictionary.) 
form.E00 (Index file) 


The update control file is required in order to Enter Data into your form 
file. It is also used to provide you with a screen in which to enter low 
and high values for selection during Produce Reports. 


The Form Data file and data dictionary is the file on which the data 
you enter into your form is placed. This file also contains a data 
dictionary at the beginning of the file. The data dictionary contains a 
table of the input areas you have identified on your form during the 
design. 


If you use the option to reference data from other forms, the data 
dictionary is used during the INSTALL FORM or INSTALL REPORT 
process to locate the data from the other forms. The data dictionary is 
also used when you INSTALL a REPORT to verify that the input area 
names you have used in your report actually exist on your data file. 


The Index file is not used until you actually enter data into the forms 
you have designed. It contains a table which is used to locate the 
data for each form in the data file based on the value of the input 
areas you have selected as reference areas during the design of your 
form. 


When data from your input form is stored on the Form Data file, data is 
compressed. For example, if in the design of your form you allocate 
three 50 character fields in which to place an address, but in most 
cases you only use an average of 20 characters on the first two lines 
for the address, only the data you enter will be placed in the Form 
Data file. You need not worry about using space on your diskette for 
an input area on your input form unless you actually enter data into 
the input area. 


Design Reports. 


When you design a report, a Source Report file is created. The name 
of the file is report.ROO where report is the name of the report 
created. This file is required only when you change the design of the 
original report, and when you select the option to INSTALL a 
REPORT. In addition, a directory of the reports you have defined for a 
form is maintained in the form.DIR file. 
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When you select the option to INSTALL a report, a file with the name 
report.MOO is created. This file is required, along with the data file 
and index file, in order to Produce the Report you have designed. 


Enter Data 


During Enter Data processing, the form.L00 file is read into memory 
from the diskette on the control file drive. 


The PEARLED program then checks to see if the form.D0O0 file is on 
the diskette on the data file drive. If it is not, you will be requested to 
place the diskette with the data file on the data file drive. 


As data is entered into the forms, the form.DOO and form.E00 files 
will be updated with the data you enter. 


Produce Reports 


During Produce Reports processing, the report.MOO0 is read from the 
control file drive. If you select to set selection control, the form.LOO 
file will also be read into memory. The form.DIR file is also used to 
obtain the directory of reports you have defined. 


At the time you request to create the report, a check will be made to 
see if the data file can be located on the diskette on the data file drive. 
If it cannot be located, you will be requested to insert the diskette 
containing the data files. 


If a sort is required in order to produce the report, you will be 
requested to place the sort diskette on the sort work drive. During the 
sort, a sorted output file is created. If the sorted output file will not fit on 
the same diskette as the input file, you will be requested to place a 
blank work diskette on the data file drive. The sorted data file will then 
be placed on this diskette. The name of the sorted output file is 
form.FOO. This file is read in place of the form.DO0 file when the 
report is produced. 


File Maintenance 


A full description of the placement of files during File Maintenance 
processing is provided in section 4. 
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MAXIMIZING DATA STORAGE 


During design and testing of designed reports, you will probably want to 
place all control files as well as test data files on the same diskette. 
However, in order to maximize the number of forms which can be placed 
on a single diskette, you may want to reconfigure files for production 
processing. Your goal in doing this will be to move the data file and data file 
index to a separate diskette. 


The following is an example of how a system may be reconfigured for 
production processing. 


Initially you will have a single diskette which will be referred to as the 
development diskette. This diskette contains the PEARL directory, the 
source files for the screens and reports you have developed, the run time 
control files for Enter Data and Produce Reports, and your test data files. 


Your goal will be to set up two diskettes to be used for production 


processing. These diskettes will be referred to as the program diskette 


and the data diskette. You will use a combination of the PIP CP/M utility 
program, and the PEARLFM program to accomplish this. Initially, both the 
program and data diskette should be blank formatted diskettes. Also 
make sure that.your development diskette has a copy of PIP.COM and 
also has a CP/M operating system on it. 


In the following procedure, the assumption is made that your system 
contains two disk drives which are drive A and B. 


a. Setting Up the Program Diskette. 


Place the development diskette on drive A and boot up your system, 
or press ctrl/C. 


Place the blank program diskette in drive B. 
Enter the following commands: 

PIP B:=A:*.DIR (to transfer directory files) 

PIP B:=A:*.L00 (to transfer update control file) 


PIP B:=A:*.MO0 (to transfer report control files) 
Or follow the steops outlined in Chapter 5, option 6. 


b. Setting Up the Data Diskette. 
Place the PEARL FILE MAINTENANCE diskette in drive A. 
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Place the development diskette in drive B. 
Enter the command: 
PEARLFM 


When the directory appears, enter the name of the program you are 
setting up for production. 


When the file maintenance service directory appears, select option 
number 4. 


You will then be requested to place the data diskette on drive A. 


At this time, a copy cf the Form Data file (form.D00) and the data file 
index (form.E00) will be copied from the development diskette on 
drive B to the program diskette on drive A. 


You will then be requested to insert the file maintenance diskette 
back into drive A, and the file maintenance menu will appear again. At 
this time, the setup of your production diskettes is complete unless 
the program you are configuring references other forms during 
update and report processing. In the latter case, return to the form 
directory and repeat the process for each program name in the set of 
related forms. 


In order to use the program and data diskette you have set up, 
simply place the program diskette in drive B when you use the 
PEARLED and PEARLPR programs. You will be requested to insert 
the data diskette in drive B each time this diskette is required for file 
update or report processing. 


FILE MAINTENANCE FUNCTIONS 


In addition to the function described above, the PEARLFM program 
provides several other services which are described below: 


a. 


File Summary Statistics 


The summary statistics, option 1 on the File Maintenance Service 
Menu, provides the following information: 


SUMMARY FILE DATA FOR: xxxxxxx.D00, 
This is the CP/M name assigned to the data file. 
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NUMBER OF RECORDS =nnnn 


This is the number of forms currently on the file. If a system 
failure occurred during an update process, this will probably be 
the number of forms at the time the update process started, and 
will not reflect new records added prior to the failure. 


FILE VERSION NUMBER=nnnn 
This is the number of times the form has been installed. 
NUMBER OF DATA FIELDS=nnnn 


This is the number of input areas on the screen which are 
Currently active. 


SPACE AVAILABLE IN DATA DICTIONARY=nnnn 


This is the number of bytes (characters) available for expansion 
of the data dictionary. New input areas may be defined on the 
input form until this space is exhausted. 


SPACE REMAINING ON DISK=nnnn 


This number times 1024 is the number of bytes which are 
available for expansion of the data on the data disk. This same 
information may be obtained through the use of the CP/M STAT 
utility. 


UNUSED SPACE=nn 


This number times 1024 is the number of bytes which are 
unused on the data file due to the deletion of data records. 


DATA FILE SIZE=nnnn 


This number times 1024 is the number of bytes which have been 
used on the data file for the form. This includes the space for the 
data dictionary which may require 4-12K when the form is 
initially installed depending upon the number of input areas on 
the input form. 


Rebuild File Index 


Rebuilding an index for a data file, option 2 on the File Maintenance 
Service Menu, is required if the integrity of the index has been lost due 
to a system or power failure during Enter Data processing, or if you 
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have redesigned your form and have added or deleted reference 
fields to the form. 


This process may take awhile if you have a large number of forms in 
your data file (say 500 to several thousand or more). The processing 
time will also increase based on the number of reference fields you 
have defined on your input form. During processing, an indicator of 
the amount of time remaining to process will be displayed on your 
screen. This is the percentage of processing yet to be completed. It 
will begin at 100 and will count down to zero. 


Copy/Compact Data File 


In order to compress a data file, select option 3 on the File 
Maintenance Service menu. You will want to use this option period- 
ically to recover space on your data file which is unavailable for use 
due to deletion and editing of forms. (The amount of space you will 
gain is indicated in the UNUSED SPACE line of the summary file 
data report described above.) 


When you have selected this option, PEARLFM will check to see if the 
COPY SOURCE DRIVE and DATA FILE DRIVE (refer to the dis- 
cussion of DISK DRIVE ASSIGNMENTS in Section 1 above) are 
assigned to the same drive. If they are, the compressed copy of the 
data file will be created on the DATA DISK. (This option should apply 
only if your data files are placed on a HARD DISK, and cannot be 
moved.) If they are not the same, you will be requested to place the 
data diskette in the drive specified by the COPY SOURCE drive. At 
this time you should make sure also that you have a blank formatted 
diskette in the DATA FILE DRIVE. (If a file which has the same name 
as the file you are copying exists on this disketted, that file will be 
deleted during the copy operation.) 


Depending upon your system disk drive assignments, you may be 
requested to insert the File Maintenance diskette after the copy is 
completed. 


After the data file has been copied and compressed, a new index will 
automatically be built for the compressed file. 


The copy and the index rebuild process may take a few minutes, 
depending upon the size of your data files. In both cases, a count- 
down of the percentage of the process which is to be completed is 
provided. 
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Create Data File 


_ This service will create a blank data file into which you may enter 


data. 


This service will be requested by other procedures in the manual or 
when the following situations occur: 


Your data file (generally on a production diskette) may become too 
large because you have approached the maximum number of 
records or forms that can be stored on it. In this case, a new data file 
On a separate disk can be created. 


Note that using this process will allow you to re-initialize a single file in 
a set of files without changing the other files during the process. This 
would be convenient in the case where one of the files on your 
program disk is a MASTER file containing data needed from one 
month to the next. The other file is a transaction file containing only 
those transactions occurring during the month, and you want to 
create a new transaction file at the beginning of each month. 


You may want to set up a production diskette from a development 
diskette. Generally, a program is tested with real data before it is 
actually used in production (production mode). This is done by adding 
records or forms to the data file, and checking the results, This 
service will get rid of all the test data that was added. 


Transfer Form Changes 


This service is used to update or transfer changes made to the form 
from the development diskette to the production diskette. This 
transfer effects only the data file and does not effect any data added 
to the data file. If a data file is not found on the production diskette (Or 
on the diskette in the program disk drive), then processing will 
terminate without completing properly, so be sure that your 
production and your development diskette each contain the data file 
for the program to which you have made changes. Once this service 
has been completed, you must also transfer the program update file 
(file type of .LOO) onto the production diskette using service option 6 
(TRANSFER PROGRAM FILES). 


This service requires two disk drives on the computer. 


In order to use this service you must first place the production 
diskette (object disk) on the program disk drive (usually drive B) and 
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then select Service 5 (TRANSFER FORM CHANGES). During the 
process of transfer, you will be asked to place the development 
diskette on disk drive “A” (or another disk work drive) temporarily. 


This service will only transfer changes made on one form at a time. If 
you need to transfer changes made on other disks, then you must 
return to the FORM DIRECTORY menu and select the other pro- 
grams that need the transfer of FORM changes. 


Transfer Program Files 


This service will transfer program files from one disk to another. It is 
most helpful when’setting up a production disk, or when a transfer of 
changes made on the development disk to the production disk is 
required. 


This service requires two disk drives on your computer. 


In order to use this service, you must first place the production 
diskette (object disk) on the program disk drive (or drive B), then 
select Service 6 (TRANSFER PROGRAM FILES). During the process 
of transfer, you will be asked to place the development diskette on 
disk drive “A” (or another disk work drive) temporarily. 


This service will only transfer files defined for one form or program at 
a time. 


Appendix F 


Control Key Commands and Menu Prompts 


DESIGN FORMS 


DESIGN FORMS - Form Layout 


FORM LAYOUT - CONTROL KEY COMMANDS - 


F - Word forward V- Insert char N -— Insert Line 


A - Word back G- Erase char Z - Scroll up 

C - Page forward T- Erase word W- Scroll down 
R - Page back Y - Erase Line 0 - Ignore & exit 
Q - HELP U - Line to top ESC - Save & exit 


PAGE: 1 LINE: 1 COL: 1 AREA NAME: 


ctrl/F 


ctrl/A 


ctri/C 


ctrl/R 


Q 


ctrl/V 


Word forward moves the cursor to the beginning of the next group 
of characters which is preceded by a space or a punctuation mark. 


Word back moves the cursor to the beginning of the group of 
characters before (to the left of) the current cursor position. 


Page forward if the input form extends beyond the bottom of the 
screen, this command will move the form up one screen. 


Page back if the input form extends beyond the top of the screen, 
this command will move the form down one screen. 


Help when a Q is entered with the cursor in column one, the help 
message for this menu is displayed. 


Insert character this command toggles the insert mode off and on. 
When in the insert mode, input characters will be inserted at the 
current cursor position. 
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ctrl/G 


etry T 


ctrl/U 


cry 


ctrl/N 


ctrl/Z 
ctrl/W 
ctrl/O 


ESCape 


PAGE: 
LINE: 


COL: 
NAME: 
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Delete character this command will delete the character at the 
Current cursor position. 


Delete word this command will delete the word at the current 
Cursor position. 


Move current line to top this command will move the current line to 
the top of the screen to continue entry. 


Delete line this command will delete the current line (to the left and 
right of the current cursor position). 


Insert line this command will insert a line at the current cursor 
position. 


Scroll up this command will shift the form up one line. 
Scroll down this command will shift the form down one line. 


Ignore & Exit this command will leave the form as it was before 
any changes were made and exit to the design forms menu. 


Save & Exit this command will save the changes made to the form 
and exit to the design forms menu. 


n this indicates the page of the form currently being displayed. 


nn this indicates the line of the current page of the form being 
displayed on which the cursor is placed. 


nn this indicates the column of current cursor position. 
This indicates that the cursor is positioned on the form in a data 


input area which has been defined to have the name shown. If no 
name is displayed, then none has yet been defined. 


DESIGN FORMS - Data Input Areas 


—— DATA INPUT AREAS - CONTROL KEY COMMANDS 


F - Word forward B - Define data input area 
A - Word back Z - Scroll up 

C - Page forward W=- Scroll down 

R — Page back 0 - Ignore & exit 

Q - Help ESC - Save & exit 


PAGE: 1 LINE: 1 COL: 1 AREA NAME: 
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The control key commands in this menu have the same functions as in the form 
>>. layout menu. One additional command is provided: 


ctrl/B Define data input area This command is executed when the 
cursor is positioned to a data area which is to be defined. When 
performed, the ctrl/B command will cause the Data Input Area 
Definition menu to be displayed. If the cursor is not positioned on a 
valid area of the form for defining a data area, a message will be 
displayed. 


____________ DATA INPUT AREA DEFINITION 
NAME THE DATA INPUT AREA HERE: 
IS INPUT REQUIRED? (Y/N) — TYPE OF INPUT? (C/D/N) — 
C=Letters/Numbers, D=Date, N=Numbers (computations) 
FORMULA FOR COMPUTATION OF INPUT (OPTIONAL): 


nn ae 


The data input area definition menu relates to a particular area on the form. In 
this menu, you will name and specify the attributes of a data area. 


NAME THE DATA INPUT AREA HERE: 


This input is required and must be a name of up to 7 letters or digits. This will be 
the name used to refer to this data area when designing reports and when 
referencing the data input area from other forms. 


IS INPUT REQUIRED? (Y/N) — 


A response of Y)es or N)o is required here. If the question is skipped, the default 
will be No. If the response is Y, when entering data on the finished form, the user 
will be required to enter data into the area before adding the record to the file. 


TYPE OF INPUT? .. 


This input will specify the kind of data to be entered into the area. “C’ areas will 
accept letters and digits and some punctuation. “D” areas will accept only valid 
dates. “N” areas will accept numbers only for computations. 


com FORMULA FOR COMPUTATION OF INPUT (OPTIONAL): 


aaa 
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This input applies only to type N)umber input areas, and is optional for them. Ifa 
computation is entered here, the data stored in the area being defined will be 
computed based on the formula enterd. Refer to Chapter 3 for detailed rules 
and examples of computations. 

Other permissible inputs: 

Q for HELP explanation about this menu. 


ESCape to exit from the menu. The inputs you have made will be saved and 
PERSONAL PEARL will return to the data input areas menu. 


DESIGN FORMS - Index for Finding Records 


— INDEX FOR FINDING RECORDS - CONTROL KEY COMMANDS __ 


F ~ Forward to area B - Select data input area 
A - Back to area Z=- Scroll up 

C - Page forward W- Scroll down 

R - Page back 0 - Ignore & exit 

Q - HELP ESC - Save & exit 


PAGE: 1 LINE: 1 COL: 1 AREA NAME: 


The control key commands in this menu have the same functions as in the form 
layout menu. One additional command is provided. 


ctrl/B Select data input area This command is executed when the cursor 
is positioned to a data input area which is to be defined as an index 
for the form. When performed, the ctrl/B command will cause the 
Building the Index menu to be displayed. If the cursor is not 
positioned on a valid area of the form for defining a data area, a 
message will be displayed. 


— BUILDING THE INDEX 
WILL YOU USE THIS AREA TO IDENTIFY AND FIND 
INDIVIDUAL RECORDS? (Y/N) Y 


WILL DATA IN THIS AREA UNIQUELY IDENTIFY ONE 
RECORD IN THIS FILE? (Y/N) Y 
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The building the index menu relates to a particular area on the form. The 
answers to the questions will specify the index attributes of the data area. 


WILL YOU USE THIS AREA TO IDENTIFY AND FIND 
INDIVIDUAL RECORDS? (Y/N) — 


If you reply N)o to this question, the area Is not set to be an index, and you will 
return to the Index for Finding Records menu. An answer of Y)es will make the 
data input area an index for the form. 


WILL DATA IN THIS AREA IDENTIFY ONE 
RECORD IN THIS FILE? (Y/N) — 


This question will determine whether the index is to be unique on not. A unique 
index will allow only one occurrence of any particular value. A nonunique index 
will allow multiple occurrences. 


You can return to the index for finding records menu by entering an ESCape. 


DESIGN FORMS - Data From Other Forms 


—— DATA FROM OTHER FORMS - CONTROL KEY COMMANDS 


F - Forward to area B - Select data inout area 
A - Back to area Z = Scroll up 

C - Page forward W - Scroll down 

R — Page back 0 - Ignore & exit 

Q - HELP ESC - Save & exit 


PAGE: 1 LINE: 1 COL: 1 AREA NAME: 


The control key commands in this menu have the same functions as in the form 
layout menu. One additional command is provided. 


ctrl/B Select data input area This command is executed when the cursor 
is positioned to a data input area which is to be defined as being 
sent from another form. When performed, the ctri/B command will 
cause the Using Data From Another Form menu to be displayed. If 
the cursor is not positioned on a valid area of the form for defining a 
data input area, a message will be displayed. 
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DESIGN FORMS - Using Data From Another Form 


——_————. USING DATA FROM ANOTHER FORM 
WHAT IS THE OTHER FORM NAME? 
WILL DATA IN THIS AREA IDENTIFY AND LINK ANOTHER FORM? (Y/N) — 
IS DATA FROM THE OTHER FORM BROUGHT INTO THIS 

AREA FOR DISPLAY ONLY? (Y/N) — 


The using data from another form menu relates to the input area name 
displayed in the last line of the menu. The responses to the questions will 
specify that the data input area is to be sent from another form, how the other 
form will be contacted, and how the data will be handled once it has been 
received. 


WHAT IS THE OTHER FORM NAME? 


This question identifies the source of the shared information. 


WILL DATA IN THIS AREA IDENTIFY AND LINK 
ANOTHER FORM? (Y/N). 


If you reply Y)es to this question, the data area will be used as the contact key 
for selecting the record from the sending (external) form. Only one identifying 
area is used to access the external form. If more than one data area is to be 
sent from the other form, one and only one area should be specified as the 
identifying data area. If the data area is not to be used as the identifying area, 
answer N)o, and the next question will be answered. 


IS DATA FROM THE OTHER FORM BROUGHT INTO THIS 
AREA FOR DISPLAY ONLY? (Y/N) — 


A response to this question of Y)es will cause the data to be displayed as it 
currently exists on the sending external form. A response of N)o will move the 
data as it exists when the current form is added and keep it in the current form 
as it is. If the data is subsequently changed on the sending form, the data will 
remain as it was in the current form. 


A response of N)o might be used to set a price for a sales transaction by 
accessing a catalog form. Then, when the price changes in the Catalog, it will 
remain in the sales transaction as it was when the transaction was entered. 
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DESIGN REPORTS 


DESIGN REPORTS - Report Layout 


REPORT LAYOUT - CONTROL KEY COMMANDS 


F - Word forward V - Insert char N - Insert Line 
A - Word back G- Erase char Z-=- Scroll up 
C- (G6) forw'd T- Erase word W- Scroll down 
R- (G) back Y - Erase Line 0 - Ignore & exit 


Q@ - HELP 


U- Line to top ESC — Save & exit 


PAGE: LINE: 71 COL: 1 AREA NAME: 


The control key commands on the report layout menu are identical in function 
to those used in the form layout menu with the exception of ctrl/C and ctri/R. 
During layout of a LIST-type report, the lower left-hand corner of the report 
layout menu is the report line group to which the line at the current Cursor 
position belongs. In the case of the above menu, the group is HEADING. The 
groups are HEADING, DETAIL, SUBTOTAL, TOTAL and FOOTING. 


Depression of ctrl/C will change report line groups. A series of ctrl/C’s will 
cycle through the groups. 


ctrl/C 


ctrl/R 


where (G) = page forward for FIXED-type reports. 
where (G) = group forward for LIST-type reports. 


where (G) = page back for FIXED-type reports. 
where (G) = group back for LIST-type reports. 


DESIGN REPORTS - Data Output Areas 


——— DATA OUTPUT AREAS - CONTROL KEY COMMANDS 


F - Word forward B - Define data output area 
A - Word back Z - Scroll up 

C- (G) forward W - Scroll down 

R- (G6) back 0 - Ignore & exit 

Q - HELP ESC - Save & exit 


PAGE: 


LINE: 1 COL: 1 AREA NAME: 


138 PERSONAL PEARL Reference Manual 


The control key commands on the report layout menu are identical in function 
to those used in the form layout. Refer to the form layout menu described above 
for details. One additional command is provided. 


ctrl/B Define data output area - this command will select the data output 
area at the current cursor position for definition. When executed, 
this command will cause the Data Output Area Definition menu to 
be displayed, 


DESIGN REPORTS - Data Output Area Definition 


DATA OUTPUT AREA DEFINITION 


NAME THE DATA OUTPUT AREA HERE: 


FORMULA FOR COMPUTATION OF OUTPUT (OPTIONAL): —__ 


The data output area name will be either a character or date type area already 
defined on a form or it will be a number area. If it is a number area, it may be 
already defined on a form or it will be calculated from other areas which are 
defined on a form. If the data area named is already defined on a form, no 
computation should be entered. If the data output area is not already defined on 
a form then a computation must be entered. 


DESIGN REPORTS - Sort Priority 


SORT PRIORITY 
INDICATE SORT PRIORITY USING INPUT AREA NAMES: 
[) a) aes) eee > Me ee, eee 


Enter R below area name to reverse order 
Press RETURN to continue, @ for HELP, or ESC to EXIT 
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In this menu, sort priority for the report is defined. If no input area names are 
entered, then the report will appear in the order in which the data was entered. 
Up to 5 areas may be specified. The first area has priortiy over the second, the 
second over the third and so on. To have priority means that the report will be 
sequenced on area 1 first. If several records have the same value for area 1, 
then they will be subsequenced by area 2. Further, if several records have the 
same value for areas 1 and 2, then they will be subsequenced by area 3 and so 
on. 


For each area, an “R” may be entered directly below the area name to indicate 
that the sort order is to be reversed. 


Note also that the first sort area is used to control subtotals on reports. 


DESIGN REPORTS - Data From Other Forms 


— ——DATA FROM OTHER FORMS - CONTROL KEY COMMANDS —— 


F ~ Forward to area B - Select data output area 
A - Back to area Z - Scroll up 

C- (G) backward W - Scroll down 

R- (G6). back 0 - Ignore & exit 

Q - HELP ESC - Save & exit 


PAGE: LINE: 1 COL: 1 AREA NAME: 


The control key commands shown for the data from other forms menu perform 
exactly like those in the form layout menu. Refer to the control key commands 
section on that menu for more details. One additional command is provided. 

ctrl/B Select data output area this command will cause the Using Data 


From Other Forms menu to be displayed with reference to the data 
area at the current cursor position. 


DESIGN REPORTS - Using Data From Another Form 


USING DATA FROM ANOTHER FORM 


WHAT IS THE OTHER FORM NAME? 


DOES DATA IN THIS AREA IDENTIFY RECORDS FROM 
ANOTHER FORM? (Y/N) — 
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WHAT IS THE OTHER FORM NAME? 


This is the name of the form which will send the data to the report. 


DOES DATA IN THIS AREA IDENTIFY RECORDS FROM 
ANOTHER FORM? (Y/N) — 


If this question is answered Y)es, then the data area will be used as the contact 
key for identifying the record from which to access the information. The data 
area must have been defined as an index on the sending form. Only one 
contact key should be defined for identifying the record from the sending form. If 
this question is answered N)o, then some other data area must be specified as 
the contact key. 


ENTER DATA ENTER DATA - Control Key Commands 


——_——— ENTER DATA — CONTROL KEY COMMANDS 

U - Save/replace record B - Switch ADD/EDIT 

N - Duplicate Last item Z - Get next record 

P - Print current record W - Get previous record 

I - Tab forward O - Delete current record 
Q - HELP ESC - EXIT 


Additional control key commands are: 


S or H — Cursor left C - Page forward 
D or L - Cursor right R - Page back 

E or K - Cursor up “4 = Tab back 

X or J - Cursor down 


Press RETURN for next page or ESC to exit 
from HELP processing. 


ctri/U 
o~ 


ctrl/B 


ctrl/P 


ctri/N 


ctri/E 
ctri/| 
ctrl/Z 


ctri/W 


Control Key Commands and Menu Prompts 141 


Save/Replace record this command will store the data from the 
form displayed on the screen to the file. If you are in ADD mode, 
the record will be added to the file. If you are in EDIT mode, the 
record will be replaced. If the data does not satisfy the design of the 
form (that is, if required data is missing or if number data is invalid 
or some other condition holds), the record will not be added and a 
message displayed. You can then remedy the situation and try a 
ctri/U again. This function is also performed when the form is 
completely filled in and a return is done. 


Change back and forth to ADD or EDIT mode this command will 
change modes. After a ctrl/B, the execution of ctrl/U will add new 
data to the file. 


When in EDIT mode, an empty form is displayed, and you are 
prompted for a key. Move the cursor to any data area which has 
been defined as an index for finding records, enter some data and 
press return. The index will be used to retrieve the record for that 
key (or within a range if you simply typed a single character or 
number). If no record exists with that key, then the next record in 
the index will be returned. That record will be displayed. Next, you 
may edit the form. 


Print current record this command will output the form as 
displayed on the screen to the printer. 


Duplicate last item this command will duplicate the data from the 
previous entry for the data area at the current cursor position. 


Move cursor up this command move the cursor up one line. 
Tab forward to next input area. 


Get next record this command may be executed in the edit mode, 
and in some cases, in the add mode. 


In the edit mode, position the cursor to a data area which has been 
defined as an index. Next, enter ctri/Z. The next record in that 
index will be displayed for editing. This command is used to browse 
forward in the file. The browsing may be done using any data areas 
which have been defined as indexes. 


In the add mode, this command is used to browse an external form 
by placing the cursor on the data area which has been defined as 
the contact key and then entering ctrl/Z. 


Get previous record this command is completely analogous to the 
ctrl/Z, get next command, except that the browsing is in the other 
direction. 
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ctrl/O 


ESCape 


ctrl/A 
ctrl/F 
ctrl/S 


ctrl/X 
ctrl/L 


ety * 
ctrl/V 
ctrl/G 
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Delete current record in ADD mode, the form will be cleared of 
current data. In EDIT mode, the current record will be deleted and 
the form cleared. 


This command will end processing in the enter data service. If a 
record is being displayed, it will not be written to the file. If in add 
mode, the current record will not be added. If in the edit mode, the 
Current record will not be rewritten to the file. 

HELP this command, when depressed with the cursor in the first 
column of a data area, will cause help explanation to be written to 
the screen. When you finish with the help text, a return will cause 
the previous form to be redisplayed. 

Move the cursor a word backward within the current data area. 
Move the cursor a word forward within the current data area. 
Move the cursor back one character. This command will cause the 
Cursor to jump to the previous data area when it runs off the 
beginning of the current data area. 

Move the cursor down to the data area most nearly directly below. 
Move the cursor ahead one character. This command will cause 
the cursor to move ahead to the next data area when it runs off the 
end of the current data area. 

Move the cursor back to the end of the previous data area. 

Turn the character insert on or off. 


Delete character at the current position. 
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PRODUCE REPORTS 


PRODUCE REPORTS 
Form Name: Report Name: 


ENTER A STEP NUMBER: 


Press RETURN to continue, Q@ for HELP, or ESC to EXIT 


This is the main produce reports menu. The form name and report name are 
displayed for information and are not entered from this menu. 


ENTER A STEP NUMBER: 


Enter the options to 1) set selection values, 2) enter printout details or 3) 
produce the final report. 


Q HELP explanation will be displayed. 
ESCape to exit. 


PRODUCE REPORTS - Printout Details 


TITLE: 


NUMBER OF REPORT LINES PER PAGE —— 


TOTAL LINES PER PAGE aaa 
(0 = Use form feed) 
FILE NAME FOR REPORT 
(Blank = Printer, CON: = Console) 
MULTIPLE FORMS ON ONE PAGE: (FIXED reports only) 
NUMBER OF FORMS ACROSS: —. SINGLE FORMWIDTH: —— (Columns) 


‘nintcacleiaitiiiaidaiitinnticnds, PRANVOUL DETALLS 
Form Name: CALENDR Report Name: INVOICE 


You may make changes by typing a new value. 


Press RETURN to continue, ? for HELP, or ESC to EXIT 
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On the Printout Details menu, the form name and report name are displayed 
for information. 


Q Help explanation will be displayed. 


ESCape exit to produce reports menu. 


THLE: 


Here you may enter a title for the report. It will appear at the top of each page of 
the report. 


NUMBER OF REPORT LINES PER PAGE — 


The answer to this question will determine how many lines of the report will 
appear on each page. The difference between this entry and the total lines per 
page is the length of the combined top and bottom margins. 


TOTAL LINES PER PAGE — 


This is the actual page length in lines. If your printer has a form feed, you may 
use it by entering 0 here. 


FILE NAME FOR REPORT 


This question will determine the destination of the report. A blank here will send 
the output to the printer. The entry of CON: will route the report to the console. 
Any other input will be used as the name of a CP/M file and the report will be 
listed to the file. File output may be subsequently edited with WordStar or used 
with some other software. 


NUMBER OF FORMS ACROSS: — 


This question is applicable to FIXED-type reports-only and is used to control 
multi-up report output (as with multiple labels across a page). 


SINGLE FORM WIDTH: 


This question also is applicable to FIXED-type reports only and is used to set 
control for multi-up output. The input here is the width in columns of an 
individual form (or label). The width is measured from the left edge of one form 
to the left edge of the next, thus including the space between. 


>. 


o> 


Appendix G 
Osborne Help Text 


This appendix contains the text for the help explanations which are provided by 
PERSONAL PEARL. If the HELP file (PRHELP.TXT) is not available during 
processing, the number for the message will be displayed rather than the text 
for the explanation. The following are the normal on-screen HELP explanations 
with the associated number. 


1 DESIGN FORMS 
PERSONAL PEARL -- DESIGN FORMS OVERVIEW 


The PERSONAL PEARL DESIGN FORMS service allows you to construct a 
FORM on the screen to use later while entering or retrieving data. This involves 
the following steps: 


1. Designing your form layout on a blank screen. 


Z Defining “data input areas” on the form where data is entered and stored 
as a record. 


3 Selecting those data input areas that can be used as a general index to 
identify and find individual records. 


4 |dentifying the data input areas requiring data from another form. 
5 Installing the finished form so data can be entered. 

2 DESIGN REPORTS 

PERSONAL PEARL -- DESIGN REPORTS OVERVIEW 


The PERSONAL PEARL DESIGN REPORTS service allows you to construct a 
REPORT layout. Designing a report requires the following steps: 


1 Designing your report layout on a blank screen. 


2 Defining “data output areas” on the report where data will be printed on 
the report. 


3 Selecting the sort order for the report. 
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4 — \dentifying the data output areas which require data from another form. 


5 Installing the finished report. 


3 ENTER DATA 
PERSONAL PEARL -- ENTER DATA OVERVIEW 


You may use the ENTER DATA service to add or edit data on a PEARL data file. 
You may also use this program to browse through your data file one record at a 
time. 


Your first step will be to select the form you wish to process. The next step will 
be to select the menu option to enter data. 


Press CONTROL Q for additional help on each menu, or enter a ? while the 
cursor is in the first character of any input area. 


4 PRODUCE REPORTS 
PERSONAL PEARL -- PRODUCE REPORTS OVERVIEW 


You may use the PRODUCE REPORTS service to create printed reports from 
data you have entered on your PEARL data files. You may also create a disk file 
for the report which may be listed later or edited with a word processing system 
and/or included in other reports you are preparing with your Osborne com- 
puter. 


During the report process, you may need to sort your data file, if you specified a 
sort priority during the design of the report. If so, you will be requested to place 
the SORT disk on A. 


Prior to creating the report you may choose low and high selection values so 
that only selected records will be included on your report. Prior to creating the 
report you may also specify a disk file name on which to place the final report. 


10 ENTER FORM NAME 


For each form defined for PERSONAL PEARL, you supply a NAME and a 
DESCRIPTION. You may enter the name of a previously defined FORM (which 
appears in the form directory), or you may create a new NAME using up to 
seven characters. 


Pressing an O while depressing the CTRL key (CTRL/O) will enable you to 
delete any program from the directory once entered. Similarly a CTRL/C will let 
you view the next page of the directory as it fills up. A CTRL/R will let you page 
backwards. 
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11. REFER TO 10 


12 ENTER PROGRAM DESCRIPTION 


The FORM DESCRIPTION is provided as an aid to you later on when you select 
a FORM from the PEARL FORM DIRECTORY. You provide the DESCRIPTION 
when you add a new FORM. 


13 ADDED 


The FORM has been added to the DIRECTORY. You may now press RETURN 
to continue with the FORM you have added, or you may enter a different name. 


14. OK TO DELETE (Y/N) 


Press “Y” if you wish to delete the FORM name you have entered, or press “N” 
if you do not want to delete the FORM. 


18 SELECT SERVICE NUMBER 

Enter 1 to design the layout of a form to be displayed during data entry. 

Enter 2 to design the layout of a report to be produced from the entered data. 
Enter 3 to enter data into the designe form. 

Enter 4 to produce the designed report. 

19 DESIGN FORMS SUBMENU 


If you are designing a new form, enter step 1. Select each of the subsequent 
steps until the form is installed. You may return to any step if you need to make 
additional changes. 


More help is available after you have selected any of the above steps. Note that 
steps 3 and 4 are optional. 


20 FORM LAYOUT 


In order to LAYOUT a FORM, enter the form layout similar to the way you would 
layout a FORM on a piece of paper in a typewriter. The areas into which data 
will be entered can be specified by using underscores (‘—" character) for 


textual information, or a “9” (for numeric) information. For example: 


NAME: CAGE: 99 SALARY: $999,999 .99 
BIRTHDATE: mm/dd/yy 
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By including common notations like “$,” “/,” or punctuation, you can insure you 
have enough character space for entering data into the input area. The Control 
Key Commands below can be activated by pressing the designated letter while 
depressing and holding the CTRL key down. ESC and ? operate alone. 


21 ATTEMPT TO INSTALL WHEN NO DATA INPUT AREAS 
SPECIFIED 


Your form cannot be installed until at least one data input area has been defined 
using option 2 of the selection menu. 


30 SELECT DATA INPUT AREAS 


After you have laid out your form, you must choose the input areas into which 
data will be placed. Do this by placing the cursor on the first character in the 
data input area. Then press the CTRL/B combination. The data input area will 
be highlighted, and you will be prompted to give the data input area a name 
(used for later reference). Specify whether the data is always required to 
complete information on the form and also whether the data will be textual, 
numeric, or a date. 


31 INPUT AREA NAME 


Enter a one to seven:character name that can be referenced later on when you 
design reports and other forms. For example: “NAME”, “ADDRESS”, “PHONE”, 
“AMOUNT”, “TOTAL”, “CUST”, “CUST2”, “T4”, and so on. The first character 
must be a letter. 


32 IS INPUT IN THIS AREA ALWAYS REQUIRED 

Enter “Y” to prevent entry operator from leaving this area blank. 
Enter “N” to allow this area to be left blank. 

33 INPUT AREA TYPE 


The “C” option allows characters including numbers to be entered. The 'N' 
option says that the data input area is numeric and so may be used in 
calculations. The 'D’ option says the data input must be a date. 


34 COMPUTATIONS FOR INPUT AREA 


A FORMULA may be entered to compute a data input area based on other 
areas in your form. You may use “+” to add values; “=” to subtract values; "*" 
to multiply two values together; and “/” to divide one value into another. 


You may also use “ €” to show the order in which a computation is to occur. For 
example: 
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(A+B) * C means to add A and B and the total is to be multiplied times C. 


If no parentheses are used, multiplications and divisions will occur before 
additions and subtractions. 


40 SELECTING INDEX AREAS 


Position on any data input area containing data to be indexed in order to find 
and identify individual records. Then press a CTRL/B combination. You will be 
prompted to enter the options associated with an indexed area. Commonly 
selected categories include: names, |.D. numbers, and so forth. 


Designating:an area to be used as an indexed area lets you go directly to the 
FORM or a set of FORMS by simply typing a keyword or number contained in 
the indexed area. 


For example, if an input area contains names, and the input area name has 
been designated as an indexed area, you may go directly to the form or set of 
forms starting with the name SMITH or JONES. 


Enter a CTRL/P to highlight those input areas which have already been 
specified as indexed areas. 


41 IS INPUT AREA AN INDEX (Y or N) 


Enter ‘“Y” to designate that the input area is an indexed area, or “N” to designate 
the area is not indexed. 


42 WILL INPUT AREA CONTAIN A UNIQUE VALUE 
(Y or N) 


Enter “Y” to show there is one and only one corresponding record for each data 
entry placed in the input area. 


Enter “N” to show there may be duplicate names or numbers entered in this 
input area. 


For example, you would probably never use the same customer id number for 
two different customers (enter Y). On the other hand you may find that two of 
your Customers happen to have the same name (enter N). 


50 INPUT AREA DATA FROM OTHER FORMS 


PERSONAL PEARL allows you to “call” information from other forms when you 
are entering data. 


For example, if one form contains summary information about customers 
including a name, address, and phone number, and another form is used to 
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record sales information for customers, you might want to get the address and 
phone number from the summary form and place it in your sales form. This is 
done by specifying that the data should be the same in both forms based on the 
Customer name. 


When you use this option, the input area name on both forms must be the same. 


For example, use CNAMECustomer NAME) on both forms to call the area into 
which customer name will be placed. You might specify CADDR and CPHONE 
on both forms also to call the address and phone number. 


Then use this option to call data input areas from the other form. Place your 
cursor on the area which also appears in the other form. Then, press CTRL/B 
to specify the way in which the data is to be used. 


You may press CTRL/P to highlight all of the input areas on your current form 
relating to other forms. 


51 THE OTHER FORM NAME 


Enter the name of the FORM containing the data input area you wish to 
reference. 


52 WILL DATA IN THIS AREA IDENTIFY RECORDS FROM 
THE OTHER FORM 


Enter Y if data in this area is used to identify and find specific records from the 
other form. Enter N if this area’s data is to be transferred from the other form. 


53 IS INPUT FROM OTHER FORM TO BE DISPLAYED 
ONLY (Y or N) 


Enter Y if the data obtained from the other form is to be displayed, but is not to 
be entered in this form. Enter N if the data is to be DISPLAYED and then 
ENTERED in this form. In the latter case you may change the data after it has 
been obtained from the other form. 


59 DESIGN REPORTS SUBMENU 


If you are designing a new report, enter option 1. Then select each of the 
subsequent steps until the report is installed. You may return to any step if you 
wish to make additional changes. More HELP is available after you have 
selected any of the above steps. 


60 ENTER REPORT NAME 


Enter the name of the report you wish to access, or enter anew name if you are 
creating a new report. 
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61 REFER TO 60 
63 ADDED 


The new report has been added to your directory. You may now enter or 
change the report layout by selecting the report for processing. Press return to 
select the new report. 


64 OK TO DELETE (Y/N) 


Enter ‘‘Y” to delete the report from your report directory, or enter “N” to keep the 
report. 


65 CREATE NEW REPORT SELECTION MENU 


Use option 1 to create a report which will use the same layout as your input form 
which you may change. 


Use option 2 to copy an existing report. Once you have made a copy of the 
report, you may change the layout of the report. 


Use option 3 to create a new report. 

66 ENTER DESCRIPTION OF THE REPORT 

The description you enter here will appear in the report directory. 
67 REPORT TO BE COPIED WAS NOT LOCATED 


The report to be copied could not be located on disk. You need to either enter a 
different report name, or press ESCAPE to return to the report directory. 


66 REPORT TYPE 


Use a FIXED type report when you want each form to appear on a separate 
page. 


Use a LIST type report when you wish to summarize the data from the input 
forms, placing as many lines as possible on each page. 


When you create a LIST type report, you may specify page headings, footings, 
summary subtotals, and grand totals. 


Use the SuperCalc spread sheet option when you wish to create a SuperCalc 
spread sheet input file from your PEARL data file. 


When you use this option, the data output areas in the report will become “cells 
in the spread sheet. 
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69 REPORT LOCATED 


The name of the report you entered has been added to the directory. The report 
layout was already on a disk file even though the name of the file was not in the 
report directory. You may now change the report layout by selecting the same 
name. 


70 DUPLICATE NAME 


The name of the report you have entered has already been used as a report 
name by another program. PEARL does not allow the same report name to be 
used by two different programs. Please choose another name. 


71 ENTER NAME OF REPORT TO COPY 


Enter the name of a report you have previously defined. If you do not remember 
the names of your reports, please press ESCAPE to return to the report 
directory and you will be able to view the report names. 


72 INPUT FORM NOT LOCATED 


The input FORM for this program has not yet been created. Use the DESIGN 
FORMS option to create the form, then select this option or choose a different 
option. 


80 LAYOUT FIXED TYPE REPORT 


In order to layout a FIXED type report, continue in the same manner you would 
to layout a FORM. 


Once you have finished the layout for the report, you may then identify the areas 
on the report where information from your data file will be placed during printing. 


82 LAYOUT SUPERCALC TYPE REPORT 


In order to create a SuperCalc spread sheet file, a report is created from your 
data file. However, instead of being printed, the information you indicate is 
placed in a file to be read in by SuperCalc for subsequent processing by that 
program. 


The SuperCalc report is similar in format to the LIST type report. Each set of 
detail, subtotal, or grand total information may be placed as a row of data in the 
SuperCalc spreadsheet. Within these three groups, each output area you 
specify will be placed as a cell in the spread sheet beginning with the second 
cell in each row. 
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83 LAYOUT ALIST TYPE REPORT 


A list type report is used if you want to list summary information, and to 
compute totals or subtotals from the information in your form file. You may 
also specify headings and footings for each page of the report. 


As you layout a LIST type report, you must specify the group category you 
are entering. The categories are: HEADING, DETAIL, SUBTOTAL, TOTAL 
and FOOTING. 


HEADING this information will appear at the top of each printed page. 


DETAIL this information will appear in the report for each input form 
processed. 


SUBTOTAL _ this information will appear in the report each time the first 
sort field changes. 


TOTAL this information will appear at the end of the report. 
FOOTING this information will appear at the bottom of each page. 


In order to change the level of the group category, press the CTRL/C 
combination. The current type of information being entered will appear in the 
bottom left-hand corner of the screen. 


Please note that once the level being entered for data has been set for a line, 
it may not be changed unless the entire line is deleted, in which case, it can 
then be retyped. Once the category level has been set, the indicator on the 
bottom of the screen will change automatically during cursor positioning. 


84 NAME AN OUTPUT AREA 


Specify the name of a data input area in your input form in order to print 
information from your data file. 


If the output area is to be computed during creation of the report, use a new 
name, then specify the formula to be used to compute the area based on 
other data areas in the input form. 


85 DESIGNATE REPORT OUTPUT AREAS 


In order to specify a new data output area in a report, place the cursor on first 
the character in the output area, and then press CTRL/B. At this time, the full 
output area will be highlighted, and you will be asked to name the area. 
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If the output area is to contain data in an input form, use the SAME NAME 
you used to name the data input area. If the new area is to be computed, or if 
the area is a computed value, then you should assign a NEW NAME. 


All of the areas specified for output are highlighted on your screen. 
87 REPORT COMPUTATIONS 


A FORMULA may be entered to compute an output area based on other 
areas in your form. Those other areas need not be present on the report as 
long as they have been defined on the input form. 


For example: if two areas on your input form are named HOURS and RATE, 
you could compute the product of these two values and place them in your 
report under the new name of GROSS by entering GROSS as the output area 
name, and using FORMULA HOURS * RATE. 


In your FORMULA, you may use “+” to add values; “=” to subtract one value 
from another; ‘“*” to multiply two values together; and “/” to divide one value 
into another. You may also used “(” to indicate the order in which the 
computation should occur. 


For example, (A+B) * C causes area A and B to be added and then the total to 
be multiplied times area C. If no parentheses are used, multiplications and 
divisions will occur before additions and subtractions. 


88 EXTERNAL FILE CONFLICT 


You may not compute a value also specified as being a data input area from 
another form. 


89 SYNTAX 

There is a syntax error in your formula. The type of the error may be as follows: 

1 Unbalanced parenthesis, 

2 Aninput area name is too long, 

3 Order of input area names and arithmetic operators (i.e. +, -, /, *) is 
invalid 

90 SPECIFYING SORT SEQUENCE 


Use this option to specify the order in which the forms on the input file will be 
placed on your report. 
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For example: if you have the input areas ZIP, STATE, and NAME on your form, 
you may specify that the file should be sorted in order by STATE, then ZIP, and 
then NAME. This is done by specifying the sequence for STATE, ZIP, and 
NAME as being 1, 2 and 3, respectively. 


The direction of a sort may be reversed by typing an R below the area specified. 


If no SORT priority is specified, then the report will be in random order as it was 
entered on the data file. 


95 DATA FROM OTHER INPUT FORMS 


Use this option to call data from other forms when a report is being created. 
Place your cursor on the area which also appears in the other form. Then press 
CTRL/B to specify the way in which the area is to be used. 


96 THE OTHER FORM NAME 


Enter the name of the FORM containing the information you wish to include in 
the report. 


97 WILL DATA IN THIS AREA IDENTIFY THE OTHER 
FORM’S RECORDS 


Enter Y if data in this area is used to identify and find specific records from the 
other form. Enter N if this area’s data is to be transferred from the other form. 


102 UPDATE/REPORT SERVICE MENU 
Enter 1 to enter or edit data. 


Enter 2 to create a report from your data file. 


103 FILE MAINTENANCE MENU 
FILE MAINTENANCE SERVICE OPTIONS 


1 FILE SUMMARY DATA--tells you how many records are on your data file, 
the file version number, the amount of unused space in your file due to 
deletion of data records, etc. 


2, REBUILD INDEX--will rebuild the index to your data file and will recover data 
records added or edited during your last update if your files were not closed 
properly during update due to an external malfunction. This option is 
required if you have changed the index specifications for an existing data 
file. 
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3 COMPACT DATA FILE--may be used to recover unused space in your data 
file which has resulted from the deletion or editing of data on the file. Use the 
FILE SUMMARY DATA option in this menu to determine how much space 
you will recover by using this option. Use of this option also causes data for 
input areas which have been deleted from a form to be removed from data 
file. 


4 CREATE DATA FILE--use this option to create a data file with no data in it. 
This option allows you to maintain multiple data files using the same form 
layout to update the file. 


5 TRANSFER FORM CHANGES--use this option to transfer the form changes 
to an existing data file. You must use this option if you have re-installed an 
existing form, and you have data files using the form on diskettes other than 
the development diskette. 


6 TRANSFER PROGRAM FILES--use this option to move ENTER DATA and 
PRODUCE REPORT program files to a production diskette from the 
development diskette. 


104 SELECT PROGRAM NAME 


Enter the name of the program you wish to process. If the name does not exist 
in the menu, you must return to the design forms or design reports program to 
add the name to the directory. 


105 SELECT NAME OF REPORT TO PROCESS 


Enter the name assigned to the report you wish to create. If you wish to create a 
new report layout, you must exit and use the PEARLDR program to design a 
new report. 


120 PRODUCE REPORTS MENU 


Enter 1 to specify which forms should be included in the report. Enter 2 to 
change the page size for the report, to send the report to a file or to the screen, 
or for label processing to specify the horizontal count for labels. Enter 3 after 
other options have been specified to create your report. 


125 ENTER SELECTION VALUES 


You may specify which forms will be included in your report by entering a low 
and a high value for each input field in your input form. 


Only those forms which have a value in the fields which is greater than or equal 
to the low value specified, AND less than or equal to the high value specified will 
be included in the report. 


PERSONAL PEARL Help Text 157 


If you wish, you may enter only a low or a high value for an input area. That is, 
both a low and high value are not required. 


Press ESCAPE when all values have been entered. 

126 EDITS COMPLETE FOR SELECTION VALUES 
Enter Y to proceed or N to continue editing current screen. 
131 NUMBER OF REPORT LINES PER PAGE 


The number of report lines per page applies only to LIST type reports. The 
number you enter specifies the number of lines which will be printed before 
skipping to the top of the next page. 


132 TOTAL LINES PER PAGE 


The total number of lines per page is the number of lines between the top of 
each page. If your printer is equipped with a FORM FEED option, enter a 0. If 
you are outputting to the console, this value is the number of lines which will be 
output before pausing to allow you to view the current page. 


133 FILE NAME FOR REPORT 


No value entered will cause your report to be printed on the CP/M list device 
assigned to your system. Enter CON: in order to output to your video screen. 
Your other option is to specify a valid CP/M file name. e.g., B;REPORT.DOC. If 
no file name is specified for a SuperCalc report, the output will automatically be 
named TEMP.CAL. 


134 RUN TIME TITLE 


The title you enter here will be printed at the top of each page of the report you 
are creating. It applies only to LIST and FIXED type reports. 


135 NUMBER OF FORMS ACROSS 


This option is for form processing when you wish to print 2 or more up labels. 
This number specifies the number of labels wide to be printed. 


136 SINGLE FORM WIDTH 


This value specifies the number of columns wide each label is when multiple up 
labels are being produced. 
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159 ENTER DATA HELP MENU 


ENTER DATA — CONTROL KEY COMMANDS 

U - Save/replace record B - Switch ADD/EDIT 

N - Duplicate last item Z - Get next record 

P - Print current record W - Get previous record 

I - Tab forward O - Delete current record 
Q - HELP ESC - EXIT 


160 ENTER DATA 
ENTER DATA —~ CONTROL KEY COMMANDS 


U - Save/replace record B - Switch ADD/EDIT 

N - Duplicate Last item Z - Get next record 

P - Print current record W —- Get previous record 

I - Tab forward 0 - Delete current record 
Q - HELP ESC - EXIT 


S or H - Cursor left C - Page forward 
D or L — Cursor right R - Page back 

E or K - Cursor up “ = Tab back 

X or J - Cursor down 


Press RETURN for next page or ESC to exit 
from HELP processing. 


While entering the data, you will find yourself in either ADD or EDIT mode. 


If you are in ADD mode, then enter data into the data input areas until you are 
done. Then press the CTRL/U key or press RETURN twice to add the record. 
The data input areas will then be cleared so you may begin entering data for the 
next record. 


You may enter EDIT mode by pressing the CTRL/B key combination. 


If you are in EDIT mode, you must first get a record from the data file in order to 
change or delete it. This can be done by entering data in any indexed area, or 
by pressing the CTRL/Z (get next record). You may then DELETE the record 
from the file (CTRL/O), or EDIT the record and then replace it on the data file 
(CTRL/U). 
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161 NO RECORD BEING EDITED 


In order to delete a record, first bring the record up for changing. A delete 
request cannot be implemented now because no record has been obtained for 
deletion. 


162 DELETE (Y/N) 


Enter a “Y” if you wish to delete the current record. Otherwise, enter a “N” to 
continue processing and not delete the record. 


163 ENTER NEW DATA 

PERSONAL PEARL is ready for you to enter data into your data file. Use the 
RETURN or TAB key to move from area to area during data entry. Press 
CTRL/O or press RETURN twice on the last field to save the record. 

164 ABANDON EDITS (Y/N) 

Enter “Y” if you wish to abandon the edits to the current screen areas. 

Enter “N” if you wish to continue editing the current data record. 

165 ENTER KEY 

PERSONAL PEARL is waiting for you to enter key work or a number in an 
indexed input area so it can identify and get get a record from your data file to 


be displayed, edited, or deleted. You may also use CTRL/Z to get the next 
record. 


166 EXIT? 

Enter “Y” to end ADD/EDIT processing. 

Enter “N” if you wish to continue entering data into your data file. 
167 CONTINUE EDITING 


Enter CTRL/B to switch to ADD mode, CTRL/Z to get next record, CTRL/W to 
get previous record. 


168 EDIT OPTION 


You have tried to use an EDIT function in ADD mode. Switch to edit using 
CTREL/B: 


169 DATA REQUIRED 


This data area is required. You must enter data into this area before the data 
record can be added. 
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170 RECORD ADDED 


The data you have entered has been added to your data file. You may now 
enter data for another record, or use the CTRL/B key to change to EDIT mode. 


171 RECORD DELETED 
The data record has been deleted. Enter CTRL/B to return to ADD mode, 


CTRL/Z to get next record, CTRL/W to get previous record, or enter a KEY 
character, word, or number in an indexed area to get another record to EDIT. 


172 RECORD REPLACED 

The data record has been replaced. Enter CTRL/B to return to ADD mode, 
CTRL/Z to get next record, CTRL/W to get previous record, or enter a KEY 
character, word, or number in an indexed input area to get another record to 
EDIT: 

173 DUPLICATE KEY 


The record cannot be added since the area specified is UNIQUE to another 
record already on your file. 


174 NUMBER TOO LARGE 


Not enough digits in the field to fit the numeric value entered. Enter a smaller 
number. 


175 INVALID DATE 

Enter date in format mmddyy or mm/dd/yy. For example: 12/31/81. 

176 NUMBER REQUIRED 

Non-numeric found in number. Enter a number. 

177 RECORD NOT FOUND 

A record on another file cannot be located based on the KEY character, word or 
number in the index area you have chosen. Enter a valid reference value, or 
CTRL/Z or CTRL/W to get next or previous record. 

1/8 END OF FILE 


You have come to the end of or the beginning of the file. 


Neu 
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181 NO UPDATE MODULE 


You have 1) attempted to process a file prior to installation; or 2) the required 
program is on another disk. Either INSTALL your program and continue, or 
place the appropriate disk with the desired program in your drive and try again. 


185 REPORT NOT INSTALLED 


The report you have selected was not located. |n order to produce your report, 
you must INSTALL it first. Return to the DESIGN REPORTS program and install 
the report. 


Appendix H 
Using SuperCalc with PERSONAL PEARL 


INTRODUCTION 


While PERSONAL PEARL can produce reports involving detailed mathematical 
calculations, the scope of mathematical operations on PERSONAL PEARL data 
can be greatly enhanced by interfacing with SuperCalc from Sorcim. 


SuperCalc (Version 1.07 compatible) is a very powerful spreadsheet program 
for performing calculations, including conditional expressions, exponentials, 
and trigonometric functions. It can be used as a stand-alone program when the 
input data is not voluminous and is readily available. However, it becomes even 
more useful when it can take advantage of the live data collecting ability of 
PERSONAL PEARL. Data from many sources can be gathered and 
Summarized by PERSONAL PEARL, and written to files that can be used by 
SuperCalc. 


SuperCalc has the capability of loading many worksheets, wholy or partially, 
into a master worksheet. Refer to the SuperCalc manual for a detailed 
discussion of designing worksheets with text and calculations. It is 
recommended that the master worksheet be “protected” in all cells which are 
not to have data loaded into them to prevent unwanted overlaying of calcul- 
ations. 


HOW TO INTERFACE WITH SUPERCALC 


PEARL interfaces with SuperCalc by outputting numeric data to a disk file 
compatible with SuperCalc. The disk file is created using a PEARL “SuperCalc- 
type’ report. Once this report has been created, the user may then design a 
master worksheet with SuperCalc and load the data into the worksheet for 
analysis. 


@e Design a SuperCalc-type report in PERSONAL PEARL. 
@ Produce the report. 
@ Design a Master Worksheet with SuperCalc. 


& Protect all calculation and text areas in the Master Worksheet. 


~ 163 - 
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# Load the Master Worksheet. 


@ Load the PEARL data report(s) into the appropriate locations in the Master 
Worksheet. 


8 The Master Worksheet is now ready for calculations, what-if 
manipulations, etc. 


An EXAMPLE: Restaurant Cost Analysis 


To illustrate the use of PERSONAL PEARL with SuperCalc, we will create a 
“Restaurant Management System”. The details of the system are given in the 
form and report layout reports at the end of this section. 


Most of the reporting in the system is done by PERSONAL PEARL. However, we 
wish to analyze the food and beverage costs and examine various “what if?” 
projections of the data. To do this, we will construct a Master Worksheet with 
SuperCalc, then merge data from two PERSONAL PEARL forms into the 
worksheet for analysis. 


THE PEARL FILES 


DAILY REVENUE 


Our first input form (JOHN - Figures 1 and 2) records daily revenue for John’s 
Restaurant, in which revenue for breakfast, lunch, dinner and the bar are 
entered. PERSONAL PEARL calculates the food total and the revenue total for 
each day. 


The report (JOHN1 - Figure 3), for this first input form subtotals the six 
categories (total revenue, bar, food total, breakfast, lunch and dinner) on a 
monthly basis. The values are written to a SuperCalc report file (JOHN1.CAL) 
with the first month's data going into cells B4, C4, D4, E4, F4, and G4. The 
second month's data goes into B5 through G8, etc. For our SuperCalc master 
spreadsheet, we will use columns C and D (Bar and Food Totals). 


DAILY PURCHASES 


The second input form, (JONPUR - Figures 4 and-5) records daily food and 
beverage purchases for John’s Restaurant, in various categories. This infor- 
mation will be used to calculate food and beverage cost percentages. Food and 
beverage purchases are recorded manually, and the totals are calculated by 
PERSONAL PEARL. 


The report (JONP1 - Figure 6) for this input form subtotals the total daily food 
purchases and the total daily beverage purchases on a monthly basis and 
records the information in columns B and C of the SuperCalc file JONP1.CAL. 
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THE SUPERCALC MASTER WORKSHEET 


The master worksheet is used to calculate food and beverage cost 
percentages on a monthly basis. Other SuperCalc reports could be created 
from the SuperCalc files generated by PERSONAL PEARL using different 
master worksheets, if desired. Still other reports could be created by extracting 
different sets of data from the input forms. 


This worksheet (COSTS.CAL - Figure 7) calculates cost percentages for both 
food and beverages, using inputs from the daily revenue report and the daily 
food and beverage purchases report. 


The Formulas 


The format in Figure 7 has been set to display formulas and the column widths 
have been adjusted accordingly. Cell D6 has the formula: 
“ TF (B6=0,0,C6*100/B6) ”, and there are similar formulas in D7 through D17 
and in G6 through G17. The formula means that: 


e lf there was no income for the month (that month has not yet been 
processed), then 


8 Store 0 in the cell, otherwise 


@ Multiply the expenses by 100, and divide the result by the 
income. 


Notice the formulas in D19 and G19 which calculate the average percentages 
by adding up the monthly percentages and dividing by the number of months 
that had any revenue. 

The Final Master Worksheet 


After all of the formulas have been entered, the display is changed to show 
results and the column widths and formats are set to display the data in the 
correct format (see Figure 8). All of the worksheet except the data areas is 
protected to avoid accidents and the form is saved on disk. 


Using the Worksheet 
First, the SuperCalc master file “COSTS” is loaded: 
/L,B:COSTS,ALL 


Then the data from the PERSONAL PEARL files is loaded (the loading order 
does not matter). The data worksheets are loaded as partial worksheets, by 
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specifying the starting and ending cell ids. Note that the location at which the 


data is to be loaded is specified 
/L,B:JOHN1,P,D1:D12,B6 
/L,B:JOHN1,P,C1:C12,E6 
/L,B:JONP1,P,B1:B12,C6 
/L,B:JONP1,P,C1:C12,F6 


by starting cell id. 


SuperCalc will automatically perform all of the calculations (Figure 9). 


FORM LAYOUT (PAGE 1) FOR JOHN 


DAILY REVENUE FOR JOHN'S RESTAURANT 


MONTH: __--___7 MONTH #: 2 WEEK #: 3 


WEEKDAY: Ws 
BREAKFAST: 
LUNCH: 
DINNER: 
FOOD TOTAL: 


BAR: 


REVENUE TOTAL: 


DAY #: 5 YEAR: —6 


pa a 


Figure 1 
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INPUT AREA ATTRIBUTES: 


1 


DATA AREA NAME: MONTH 
DATA AREA TYPE: CHARACTER 


123456789 
REQUIRED DATA 
DATA AREA IS UNIQUE INDEX 


DATA AREA NAME: MON 

DATA AREA TYPE: CHARACTER 
12 

REQUIRED DATA 


DATA AREA NAME: WEEK 
DATA AREA TYPE: CHARACTER 


12 
DATA AREA NAME: WEEKDAY 
DATA AREA TYPE: CHARACTER 


123456789 

DATA AREA NAME: DAY 

DATA AREA TYPE: CHARACTER 
ar 

REQUIRED DATA 


DATA AREA NAME: YEAR 
DATA AREA TYPE: CHARACTER 


1234 
DATA AREA NAME: BRK 
DATA AREA TYPE: NUMBER 


2299 
1234 


10 


11 


12 


DATA AREA NAME: LUN 
DATA AREA TYPE: NUMBER 


227 
1234 


DATA AREA NAME: DIN 
DATA AREA TYPE: NUMBER 


2999 

1234 

DATA AREA NAME: FOOD 
DATA AREA TYPE: NUMBER 


99999 
12345 
COMPUTATION: BRK+LUN+DIN 


DATA AREA NAME: BAR 
DATA AREA TYPE: NUMBER 
99999 


12345 


DATA AREA NAME: TOT 
DATA AREA TYPE: NUMBER 
99999 

12345 

COMPUTATION: FOOD+BAR 
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DAILY REVENUE FOR JOHN'S RESTAURANT 


MONTH: AUGUST MONTH #: 8 WEEK #: 1 
WEEKDAY: MONDAY DAY #: 2 YEAR: 1982 
BREAKFAST: 32 
LUNCH: 86 
DINNER: 111 
FOOD TOTAL: 229 


BAR: 223 


REVENUE TOTAL: 452 


Figure 2 


REPORT NAME: JOHN1, FORM NAME: JOHN 


MONTHLY FORECASTING DATA FOR JOHN'S RESTAURANT 


TOTAL REVENUE BAR FOOD TOTAL BREAKFAST LUNCH DINNER 


SUBTOT 


ae es sesso ee a es 
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REPORT DESCRIPTION: SUPERCALC REPORT FOR FORECASTING 
REPORT TYPE: SUPERCALC 

SORT SEQUENCE: MON 

REPORT OUTPUT AREA ATTRIBUTES: 

1 DATA AREA NAME: STOT 


22999 
12345 
COMPUTATION: STOT+TOT 


2 DATA AREA NAME: SBAR 
99999 


12345 
COMPUTATION: SBAR+BAR 


5 DATA AREA NAME: SFOOD 


22999 
12345 
COMPUTATION: SFOOD+ FOOD 


4 DATA AREA NAME: SBRK 


12345 
COMPUTATION: SBRK+BRK 


5 DATA AREA NAME: SLUN 
99999 


12345 
COMPUTATION: SLUN+LUN 


6 DATA AREA NAME: SDIN 


22909 
12345 
COMPUTATION: SDIN+DIN 
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FORM LAYOUT (PAGE 1) FOR JONPUR 


DAILY FOOD AND BEVERAGE PURCHASES FOR JOHN'S RESTAURANT 


YEAR: 1 MONTH: _.__=§-2 MONTH #: 3 DAY: .4 


FOOD BEVERAGES 
MEAT: ciate BEER: geal 
PRODUCE: ae 3 WINE: ee.” 
STAPLES: —_9 LIQUOR: ait 
OTHER: Pee i | OTHER: a | 
TOTAL: pee TOTAL ees | 

Figure 4 


INPUT AREA ATTRIBUTES: 


1 


DATA AREA NAME: YEAR 
DATA AREA TYPE: CHARACTER 
1234 

REQUIRED DATA 


DATA AREA NAME: MONTH 
DATA AREA TYPE: CHARACTER 


12345678 

REQUIRED DATA 

DATA AREA NAME: MON 

DATA AREA TYPE: CHARACTER 

12 

REQUIRED DATA 

DATA AREA IS NON UNIQUE INDEX 


DATA AREA NAME: DAY 

DATA AREA TYPE: CHARACTER 
12 

REQUIRED DATA 


10 


11 


g Fe 


13 


14 
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DATA AREA NAME: MEAT 
DATA AREA TYPE: NUMBER 


227? 
1234 


DATA AREA NAME: BEER 
DATA AREA TYPE: NUMBER 


2292 
1234 


DATA AREA NAME: PROD 
DATA AREA TYPE: NUMBER 
para 

123 

DATA AREA NAME: WINE 
DATA AREA TYPE: NUMBER 


2772 
1234 


DATA AREA NAME: STAP 
DATA AREA TYPE: NUMBER 
299 

1234 

DATA AREA NAME: LIQ 
DATA AREA TYPE: NUMBER 
9999 


1234 
DATA AREA NAME: FOTH 
DATA AREA TYPE: NUMBER 


9999 
T2534 


DATA AREA NAME: BOTH 
DATA AREA TYPE: NUMBER 


222. 

125 

DATA AREA NAME: FTOT 
DATA AREA TYPE: NUMBER 


22090 
12345 
COMPUTATION: MEAT+PROD+STAP+FOTH 


DATA AREA NAME: BTOT 
DATA AREA TYPE: NUMBER 


2 
12345 
COMPUTATION: BEER+WINE+L1@Q+BOTH 
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DAILY FOOD AND BEVERAGE PURCHASES FOR JOHN'S RESTAURANT 


YEAR: 1982 MONTH: JANUARY MONTH #: 1 DAY: 1 


FOOD BEVERAGES 
MEAT: 126 BEER: ) 
PRODUCE: 35 WINE: 35 
STAPLES: 200 LIQUOR: 128 
OTHER: 40 OTHER: 0 
TOTAL: 401 TOTAL 163 

Figure 5 


REPORT NAME: JONP1, FORM NAME: JONPUR 


MONTHLY FOOD AND BEVERAGE EXPENSES FOR JOHN'S RESTAURANT 


SUBTOT 


FOODS ccc BEVERAGES: 2 


Figure 6 


REPORT DESCRIPTION: SUPERCALC REPORT FOR PURCHASES 
REPORT TYPE: SUPERCALC 
SORT SEQUENCE: MON 
REPORT OUTPUT AREA ATTRIBUTES: 
1 DATA AREA NAME: SFTOT 
99999 


12345 
COMPUTATION: SFTOT+FTOT 


2 DATA AREA NAME: SBTOT 


12345 
COMPUTATION: SBTOT+BTOT 
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| oA il B | D 

11 FOOD AND BEVERAGE ANALYSIS 

2 | F17 

3 | 

4 | INCOME EXPENSES COST % 

5 | 

6 JANUARY IF (B6=0,0, C6*100/B6) 
7 |FEBRUARY IF (B7=0,0,C7*100/B7) 
8 IMARCH IF (B8=0,0,C8*100/B8) 
9 IAPRIL IF (B9=0,0,C9*100/B9) 
40 IMAY IF (B10=0,0,C10*100/B10) 
11 |JUNE 1F(B11=0,0,C11*100/B11) 
12 JULY IF (B12=0,0,C12*100/812) 
13 IAUGUST IF (B13=0,0,C13*100/B13) 
14 |SEPTEMBER IF (B14=0,0,C14*100/B14) 
15 |OCTOBER IF (B15=0,0,C15*100/B15) 
16 INOVEMBER IF (B16=0,0,C16*100/B16) 
17 IDECEMBER IF (B17=0,0,C17*100,B17) 
18 | ea 
19 ITOTALS SUM(B5:B18)UM(C5:C18) SUM(D6:D17)/ COUNT (B6:B17) 
20 | 

ae: if ¥ G 

1 IIS FOR JOHN'S RESTAURANT 

2 | BEVERAGES 

3 | 

4| INCOME EXPENSES 

5 | 

6 | IF (E6=0,0,F6*100/E6) 

ai 1F(E7=0,0,F7*100/E7) 

8 | IF (E8=0,0,F8*100/E8) 

9 | IF (E9=0,0,F9*100/E9) 

10 | IF (E10=0,0, F10*100/E10) 

11 IF (E11=0,0,F11*100/E11) 

12 | IF (E12=0,0,F12*100/E12) 

13 | IF (E13=0,0,F13*100/E13) 

44 | IF (E14=0,0,F14*100/E14) 

15 | IF (E15=0,0,F15*100/E15) 

16 | IF (E16=0,0, F16*100/E16) 

17 | IF (E17=0,0,F17*100,E17) 

18 | —__—____—— 


19 | SUMCE5:E18)UM(F5: F18) 


20 | 


SUM(G6: G17) / COUNT (B6:B17) 


Figure 7 
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| oA Ay se. i og t fu oe - -¢ ll G 

1 | FOOD AND BEVERAGE ANALYSIS FOR JOHN' RESTAURANT 

2 | FOOD BEVERAGES 

3| 

4 | INCOME EXPENSES COST % INCOME EXPENSES COST % 

5 | 

6 |JANUARY -00 -00 

7 |FEBRUARY -00 00 

8 IMARCH -00 -00 

9 IAPRIL -00 -00 
10 IMAY -00 -00 
11 IJUNE -00 -00 
12 IJULY -00 -00 
13 |AUGUST -00 -00 
14 ISEPTEMBER -00 -00 
15 IOCTOBER -00 -00 
16 INOVEMBER -00 -00 
17 IDECEMBER -00 -00 
18 | 

19 ITOTALS a) O ERROR 0 O — ERROR 
20 | 

Figure 8 
| A | | B | | C | | eS ° 4 E | | F ll G 

1| FOOD AND BEVERAGE ANALYSIS FOR JOHN' RESTAURANT 

2 | FOOD BEVERAGES 

3| 

4 | INCOME EXPENSES COST % INCOME EXPENSES COST % 

5 | 

6 |JANUARY 7547 3226 42.75 4455 1221 27.41 
7 |FEBRUARY 6566 2725 3841.50 5212 1547 29.68 
8 IMARCH 8111 3210 39.58 5000 1498 29.96 
9 |APRIL 7878 3179 = 40.35 5521 1708 30.94 
10 IMAY 8668 3397 =. 339.19 5835 1769 30.32 
11 IJUNE 10046 3879 38.61 6483 1879 28.98 
12 IJULY 10304 3979 38.62 6706 1869 27.87 
13 |AUGUST -00 -00 
14 ISEPTEMBER -00 -00 
15 |OCTOBER -00 -00 
16 INOVEMBER -00 -00 
17 IDECEMBER -00 -00 
18 | 
19 ITOTALS 68005 27192 40.13 45109 13270 29.42 


Figure 9 
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